Lxd MCP

🚀 LXD MCP サーバー

LXDコンテナと仮想マシンを管理するためのモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

このMCPサーバーは以下のツールを提供します。

インスタンス管理

• list_instances - すべてのLXDインスタンス（コンテナとVM）をリストする
• get_instance - 特定のインスタンスの詳細情報を取得する
• get_instance_state - インスタンスの現在の状態とリソース使用量を取得する
• create_instance - 新しいLXDインスタンス（コンテナまたはVM）を作成する
• delete_instance - インスタンスを削除する
• rename_instance - インスタンスを改名する
• update_instance - インスタンスの設定（例：CPU、メモリ制限）を更新する

インスタンスのライフサイクル

• start_instance - 停止しているインスタンスを起動する
• stop_instance - 実行中のインスタンスを停止する（強制停止もサポート）
• restart_instance - 実行中のインスタンスを再起動する
• freeze_instance - 実行中のインスタンスを凍結（一時停止）する
• unfreeze_instance - 凍結されたインスタンスを解除（再開）する

インスタンス操作

• exec_instance - インスタンス内でコマンドを実行する

イメージ管理

• list_images - 利用可能なイメージをリストする

📋 前提条件

• システムにLXDがインストールされ、実行されていること
• Go 1.25.4以上
• LXD Unixソケットへのアクセス権（通常はユーザーがlxdグループに所属している必要があります）

📦 インストール

1. サーバーをビルドします：

make build

2. バイナリがPATHに含まれていることを確認するか、設定時にその完全パスをメモしておきます。

💻 使用例

GitHub Copilot CLIを使用する場合

このMCPサーバーを使用する最も簡単な方法は、GitHub Copilot CLIを使用することです：

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サーバーは、stdin/stdoutを介して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
    }
  }
}

🔧 技術詳細

サーバーはLXD Goクライアントライブラリ（github.com/canonical/lxd/client）を使用して、/var/snap/lxd/common/lxd/unix.socket（または非スナップインストールの場合は/var/lib/lxd/unix.socket）のUnixソケットを介してLXDと通信します。

プロジェクト構造

lxd-mcp/
├── main.go                          # アプリケーションのエントリポイント
├── internal/
│   ├── lxd/                         # LXDツールパッケージ
│   │   ├── client.go                # ツール構造体とLXD接続
│   │   ├── types.go                 # 引数の型定義
│   │   ├── instances.go             # インスタンスのCRUD操作
│   │   ├── lifecycle.go             # 起動/停止/再起動操作
│   │   ├── exec.go                  # コマンド実行
│   │   └── images.go                # イメージ管理
│   └── server/                      # MCPサーバーの設定
│       └── server.go                # ツールの登録とサーバーの初期化
└── doc/                             # ドキュメントのアセット

🚀 将来的な機能拡張

潜在的な追加機能：

• [ ] スナップショット管理
• [ ] ファイルのプッシュ/プル操作
• [ ] ネットワーク設定
• [ ] ストレージプール管理
• [ ] プロファイル管理
• [ ] ログアクセス
• [ ] イメージのインポート/エクスポート
• [ ] メタデータAPIの統合
• [ ] ドキュメントエンドポイントの統合（スナップ）

⚠️ セキュリティに関する考慮事項

• サーバーはLXDアクセス権限が必要です（ユーザーはlxdグループに所属している必要があります）
• コンテナ内でのコマンド実行にはセキュリティ上の影響があります
• 本番環境での使用には認証を実装することを検討してください
• すべての入力パラメータを検証してください