MCP Nutanix

🚀 MCP Nutanix中国区オープンソースプロジェクト紹介

このプロジェクトは、Model Context ProtocolフレームワークのGo言語での応用能力を探索することを目的としています。

⚠️ 注意事項

これは中国地区の実験的なオープンソースプロジェクトです

• 非公式製品：Nutanix社の公式製品やツールではありません。
• サポート保証なし：Nutanixからのサポート、承認、またはメンテナンスはありません。
• 本番環境不適合：正式な本番環境には適していません。
• 現状提供：一切の保証や保険はありません。

リスク自負：作者は、このコードの使用によって生じる可能性のある問題、損害、または障害について責任を負いません。

✨ 主な機能

このMCPサーバーは、大規模言語モデル（LLMs）がNutanix Prism Centralとのやり取りを通じて以下の機能を実現できるようにします。

1. ユーザーの資格情報を使用してPrism Centralインスタンスに接続する。
2. さまざまなリソース（仮想マシン、クラスター、ホストなど）をリストする。
3. URIベースのアクセスにより、特定のリソースの詳細情報を取得する。

この実装では、Prism Goクライアントを使用してPrism Centralと通信し、MCP Goライブラリを使用してModel Context Protocolを実装しています。

🚀 クイックスタート

前提条件

• Go言語バージョン1.23以上
• Nutanix Prism Centralインスタンスへのアクセス権限
• 構築にはmakeやgo fmtなどのツールの使用をおすすめします。

プロジェクトの構築

# リポジトリをクローンする
git clone https://github.com/thunderboltsid/mcp-nutanix.git
cd mcp-nutanix

# MCPサーバーを構築する
make build

サーバーの起動

./bin/mcp-nutanix

起動後、システムはPrism Centralの資格情報の入力を求めます。

💻 使用例

基本的な使用法

MCPサーバーがPrism Centralインスタンスに接続され、正常に動作している場合、大規模言語モデルはMCPプロトコルを介してそれとやり取りできます。

リソースのリスト表示

リソースをリストするには、以下のコマンドを使用します。

vms
clusters
hosts
images
subnets

大規模言語モデルはJSON形式のリソースリストを受け取り、それを解析して分析することができます。

リソースのアクセス

特定のリソースにアクセスするには、URIベースの構文を使用します。

vm://{uuid}
cluster://{uuid}
host://{uuid}

大規模言語モデルは指定されたリソースの詳細なJSON情報を受け取ります。

📚 ドキュメント

プロジェクト構造

mcp-nutanix/
├── bin/                  # コンパイル後のバイナリファイルの保存場所
├── internal/             # 内部コンポーネントパッケージ
│   ├── client/           # Prism Centralクライアントの処理ロジック
│   ├── codegen/          # コード生成ツール
│   └── json/             # JSONデータ処理の補助関数
├── pkg/                  # 核心機能コンポーネント
│   ├── prompts/          # MCPプロトコルのプロンプト実装
│   ├── resources/        # リソースの処理ロジック
│   └── tools/            # ツールセットの処理ロジック
└── Makefile              # 構築とコマンドツールのファイル

コード生成

このプロジェクトでは、コード生成技術を使用してリソースとツールの処理モジュールを作成しています。これらの内容を更新するには、以下のコマンドを使用します。

make generate

🔧 技術詳細

• 応答サイズはMCPプロトコルの制限を受けます。
• 大量のデータを返すリソースについては、エラーが発生する可能性があります。
• 現在のバージョンでは、ページング機能はサポートされていません。
• 読み取り操作のみがサポートされており、作成、更新、または削除機能はまだ実装されていません。