Proxmox MCP Server

Proxmox MCP サーバー

これは、LLM にインフラストラクチャのコンテキストを提供するために Proxmox VE サーバーと連携する Model Context Protocol（MCP）サーバーです。このサーバーは、LLM が Proxmox クラスター、ノード、仮想マシンに関する情報を問い合わせるためのさまざまなエンドポイントを公開します。

機能

• クラスター全体の情報を取得
• 特定のノードの詳細を問い合わせ
• VM の情報とステータスを取得
• クラスター内のすべての VM を一覧表示
• 簡単にデプロイできる Docker および Docker Compose のサポート
• 環境変数を使用した安全な認証情報の管理

前提条件

• Python 3.11 以降
• Docker および Docker Compose
• Proxmox VE サーバーへのアクセス
• Proxmox API の認証情報

インストール

1. リポジトリをクローンします
2. .env.example を .env にコピーし、Proxmox の認証情報を更新します。

   cp .env.example .env
   

3. .env ファイルを Proxmox の認証情報で更新します。

   PROXMOX_HOST=your_proxmox_host
   PROXMOX_USER=your_proxmox_user@pam
   PROXMOX_PASSWORD=your_proxmox_password
   PROXMOX_VERIFY_SSL=false
   

Docker Compose での実行

1. コンテナーをビルドして起動します。

   docker-compose up --build
   

2. サーバーは http://localhost:8008 で利用できます

API エンドポイント

MCP サーバーは、次のコンテキストエンドポイントを提供します。

• get_cluster_info：Proxmox クラスターの一般的な情報を返します
• get_node_info：特定の Proxmox ノードの詳細情報を返します
• get_vm_info：特定の VM の詳細情報を返します
• list_vms：クラスター内のすべての VM の一覧を返します

開発

開発用にサーバーをローカルで実行するには、次の手順に従います。

1. 仮想環境を作成します。

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. サーバーを実行します。

   uvicorn src.main:app --reload
   

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します。

   git checkout -b feature/my-new-feature
   

3. テストを実行し、コードをフォーマットします。

   pytest
   black src/ tests/
   flake8 src/ tests/
   

4. 変更をコミットします。

   git commit -am 'Add some feature'
   

5. ブランチにプッシュします。

   git push origin feature/my-new-feature
   

6. マージリクエストを提出します

開発ガイドライン

• PEP 8 スタイルガイドに従います
• 新機能のテストを作成します
• 必要に応じてドキュメントを更新します
• 型ヒントを使用します
• 明確なコミットメッセージを記述します

ライセンス

MIT