Lxd MCP

🚀 LXD MCP 服務器

這是一個用於管理 LXD 容器和虛擬機的模型上下文協議（MCP）服務器，能為你提供便捷、高效的 LXD 實例管理方案。

🚀 快速開始

前提條件

• 系統已安裝並運行 LXD。
• 安裝 Go 1.25.4 或更高版本。
• 擁有訪問 LXD Unix 套接字的權限（通常要求用戶加入 lxd 組）。

安裝步驟

1. 構建服務器：

make build

2. 確保二進制文件已添加到系統路徑，或記錄其完整路徑以便後續配置使用。

使用方法

通過 GitHub Copilot CLI 使用

這是使用此 MCP 服務器最簡單的方式：

1. 運行以下命令添加服務器：

/mcp add lxd-mcp-server

2. 當系統提示時，提供 lxd-mcp-server 二進制文件的完整路徑（例如 /home/user/git/lxd-mcp/lxd-mcp-server）。
3. 服務器將自動完成配置，你可以在 Copilot CLI 會話中開始使用 LXD 工具。
4. 若要驗證服務器是否正常運行，可讓 Copilot 列出你的 LXD 實例或執行其他 LXD 操作。

直接使用

MCP 服務器還支持通過 JSON - RPC 2.0 協議在標準輸入/輸出上進行通信：

./lxd-mcp-server

工具調用示例

列出所有實例

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_instances",
    "arguments": {}
  }
}

創建一個實例

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_instance",
    "arguments": {
      "name": "my-container",
      "image": "ubuntu:24.04",
      "type": "container",
      "start": true
    }
  }
}

獲取實例詳細信息

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "my-container"
    }
  }
}

更新實例配置

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "name": "my-container",
      "config": {
        "limits.cpu": "2",
        "limits.memory": "2GiB"
      }
    }
  }
}

啟動一個實例

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "start_instance",
    "arguments": {
      "name": "my-container"
    }
  }
}

執行一條命令

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "exec_instance",
    "arguments": {
      "name": "my-container",
      "command": ["ls", "-la", "/"]
    }
  }
}

刪除一個實例

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "delete_instance",
    "arguments": {
      "name": "my-container",
      "force": true
    }
  }
}

✨ 主要特性

此 MCP 服務器提供以下工具：

實例管理

• list_instances - 列出所有 LXD 實例（容器和虛擬機）。
• get_instance - 獲取特定實例的詳細信息。
• get_instance_state - 獲取實例的當前狀態和資源使用情況。
• create_instance - 創建一個新的 LXD 實例（容器或虛擬機）。
• delete_instance - 刪除一個實例。
• rename_instance - 重命名一個實例。
• update_instance - 更新實例配置（例如，CPU、內存限制）。

實例生命週期管理

• start_instance - 啟動一個已停止的實例。
• stop_instance - 停止一個正在運行的實例（支持強制停止）。
• restart_instance - 重啟一個正在運行的實例。
• freeze_instance - 凍結（暫停）一個正在運行的實例。
• unfreeze_instance - 解凍（恢復）一個已凍結的實例。

實例操作

• exec_instance - 在實例中執行命令。

鏡像管理

• list_images - 列出可用的鏡像。

🔧 技術細節

架構

服務器使用 LXD Go 客戶端庫（github.com/canonical/lxd/client）通過 Unix 套接字 /var/snap/lxd/common/lxd/unix.socket（非 Snap 安裝為 /var/lib/lxd/unix.socket）與 LXD 進行交互。

項目結構

lxd-mcp/
├── main.go                          # 應用程序入口點
├── internal/
│   ├── lxd/                         # LXD 工具包
│   │   ├── client.go                # 工具結構體和 LXD 連接
│   │   ├── types.go                 # 參數類型定義
│   │   ├── instances.go             # 實例的創建、讀取、更新和刪除操作
│   │   ├── lifecycle.go             # 啟動/停止/重啟操作
│   │   ├── exec.go                  # 命令執行
│   │   └── images.go                # 鏡像管理
│   └── server/                      # MCP 服務器設置
│       └── server.go                # 工具註冊和服務器初始化
└── doc/                             # 文檔資源

🚧 未來增強功能

• [ ] 快照管理
• [ ] 文件上傳/下載操作
• [ ] 網絡配置
• [ ] 存儲池管理
• [ ] 配置文件管理
• [ ] 日誌訪問
• [ ] 鏡像導入/導出
• [ ] 元數據 API 集成
• [ ] 文檔端點集成（snap）

⚠️ 安全注意事項

• 服務器需要 LXD 訪問權限（用戶必須加入 lxd 組）。
• 在容器中執行命令存在安全風險。
• 生產環境使用時，建議實現身份驗證機制。
• 對所有輸入參數進行驗證。