Harvester MCP Server

🚀 Harvester MCP サーバ

Harvester HCI の Model Context Protocol (MCP) サーバです。Claude Desktop、Cursor やその他の AI アシスタントが MCP プロトコルを通じて Harvester クラスタとやり取りできるようにします。

🚀 クイックスタート

Harvester MCP Server は、Model Context Protocol (MCP) の Go 言語による実装で、Harvester HCI 向けに特別に設計されています。これにより、Claude Desktop や Cursor などの AI アシスタントが Harvester クラスタ（本質的には Harvester 固有の CRD を持つ Kubernetes クラスタ）に対して CRUD 操作を実行できるようになります。

✨ 主な機能

Harvester MCP Server は、AI アシスタントと Harvester クラスタの間のギャップを埋める役割を果たします。以下のダイアグラムはその仕組みを示しています。

graph LR;
    subgraph "AI アシスタント"
        A[Claude Desktop] --> C[MCP クライアント];
        B[Cursor IDE] --> C;
    end
    
    subgraph "MCP サーバ"
        C --> D[Harvester MCP Server];
    end
    
    subgraph "Kubernetes クラスタ"
        D --> E[Kubernetes API Server];
    end

📦 インストール

インストール手順

1. リポジトリをクローンする:

   git clone https://github.com/your-repository/harvester-mcp-server.git
   cd harvester-mcp-server
   

2. 依存関係をインストールする:

   • Go モジュールを使用して依存関係を管理します。

     go mod tidy
     

3. バイナリファイルをビルドする:

   go build -o bin/harvester-mcp-server ./cmd/harvester-mcp-server/
   

MCP サーバの設定

1. 環境変数を設定する：

   • Kubernetes 設定ファイルのパスを設定します。

     export KUBECONFIG=/path/to/your/kubeconfig.yaml
     

   • ログレベルを設定します（オプション）。

     export LOG_LEVEL=info
     

2. サーバを起動する:

   ./bin/harvester-mcp-server --kubeconfig /path/to/kubeconfig.yaml --log-level info
   

💻 使用例

基本的な使用法

Claude Desktop との連携

1. 設定ファイルを編集する：

   • ~/Library/Application\ Support/Claude/claude_desktop_config.json を開きます。
   • Harvester MCP サーバを mcpServers に追加します。

     {
       "mcpServers": {
         "harvester": {
           "command": "/path/to/harvester-mcp-server",
           "args": ["--kubeconfig", "/path/to/kubeconfig.yaml", "--log-level", "info"]
         }
       }
     }
     

2. Claude Desktop を再起動する：

   • 設定を適用するために、Claude Desktop を再起動します。

3. MCP 機能を使用する：

   • これで、Claude Desktop 内で Harvester MCP の機能を使用できます。

サンプルクエリ

• "私の Harvester クラスタにはいくつのノードがありますか？"
• "cattle-system ネームスペース内のすべてのポッドをリストアップしてください。"
• "cattle-system ネームスペース内の rancher-789c976c6-xbvmd という名前のポッドの詳細を表示してください。"
• "デフォルトネームスペース内のすべての仮想マシンをリストアップしてください。"
• "harvester-system ネームスペースで実行中のサービスは何ですか？"

📚 ドキュメント

開発に関する情報

プロジェクト構造

cmd/harvester-mcp-server/
pkg/

新機能の追加

1. 新しいリソースタイプを追加する：

   • pkg/kubernetes/types.go で新しいリソースタイプを追加します。

2. フォーマッタを実装する：

   • 対応するフォーマットファイルで新しいリソースのフォーマッタを実装します。

3. ツールを登録する：

   • pkg/mcp/server.go の registerTools メソッドで、統一されたリソースハンドラを使用して新しいツールを登録します。

📄 ライセンス

このプロジェクトは、Apache License 2.0 の下で配布されています。詳細については、LICENSE ファイルを参照してください。