Nutanix MCP Server Jp

🚀 Nutanix MCP サーバー

Nutanix Prism Central と Nutanix クラスターおよび仮想マシンの情報をやり取りする MCP (モデルコンテキストプロトコル) サーバーの FastAPI 実装です。

🚀 クイックスタート

本プロジェクトは、Nutanix 環境向けの Model Context Protocol (MCP) サーバーの最小実行可能製品（MVP）を実現することを目的としています。主な目標は、FastAPI を利用して Nutanix Prism Central からクラスター情報を取得することです。この MVP は、将来的な機能拡張（より多くの種類の情報の取得、モデル操作の実行、セキュリティの強化など）の基礎となります。

なお、本プロジェクトはプロトタイプ開発であるため、本番環境での使用は避けてください。

✨ 主な機能

• Nutanix Prism Central との情報交換を通じて、クラスター情報を取得します。
• 将来的には、より多くの種類の情報の取得やモデル操作、セキュリティの強化などの機能拡張が予定されています。

📦 インストール

動作環境

• オペレーティングシステム: macOS、Linux、Windows（WSL2 を含む）
• Python バージョン: 3.12 以上を推奨
• pip バージョン: 23.x 以上を推奨
• Nutanix Prism Central API バージョン: v4.0.2（クラスター管理 API）
• Nutanix Prism Central API バージョン: v4.0（仮想マシン管理 API）

セットアップ手順

# リポジトリをクローン
git clone https://github.com/takanorisuzuki/nutanix-mcp-server-jp.git
cd nutanix-mcp-server-jp

# 仮想環境を作成してアクティブ化（オプション）
python3 -m venv venv
source venv/bin/activate  # Windows システムの場合は venv\Scripts\activate を使用
# 依存パッケージをインストール
pip install -r requirements.txt

# サンプル .env ファイルをコピー
cp .env.example .env

.env ファイルの設定方法

以下の形式で .env ファイルを作成し、認証情報と接続情報を定義します。

PRISM_CENTRAL_IP=192.168.10.11
PRISM_CENTRAL_PORT=9440
PRISM_CENTRAL_USERNAME=admin
PRISM_CENTRAL_PASSWORD=your_password_here
# SSL 証明書を検証する（コメントアウトすると SSL 検証が無効になります）
# PRISM_CENTRAL_VERIFY_SSL=false

⚠️ 重要提示

.env ファイル内のパスワードは平文で使用しないでください。環境変数または暗号化方式を使用して保存することをおすすめします。

📚 ドキュメント

更新履歴

• 2025-04-18: バージョン v0.1.0 をリリース
  • /clusters と /vms インターフェースを実装
  • Nutanix Prism Central 接続を統合
  • FastAPI を利用して REST API サービスを構築
  • 認証情報と接続アドレスを .env ファイルに外部化
  • Dify 連携用に OpenAPI スキーマを調整

貢献方法

ご協力いただけることを歓迎します。機能改善やバグ修正については、Pull Request を通じて提出してください。重大な変更を行う前には、Issue を作成して議論してください。

ライセンス

本プロジェクトは、LICENSE ファイルの条件に基づいてライセンスされています。

将来の拡張計画

• 仮想マシンの詳細情報（NIC やディスク構成など）を追加
• クラスターごとに詳細情報を表示するインターフェースを実装
• Nutanix API vmm を統合し、操作系 API（仮想マシンの起動/停止など）を導入
• Dify との対話型操作をサポート