mcpField
N
nutanix-mcp-server

nutanix-mcp-server

Local
github.com/takanorisuzukiCloud & Infra1Updated 79w ago
Repository

About nutanix-mcp-server

nutanix-mcp-server is a FastAPI-based prototype for retrieving cluster and virtual machine information from Nutanix Prism Central. It provides basic endpoints for infrastructure data and includes an OpenAPI schema for Dify custom-tool registration; the README cautions against production use.

Key features

  1. 01Retrieve cluster information
  2. 02Retrieve virtual machine information
  3. 03Connect to Prism Central APIs
  4. 04Configure credentials through .env
  5. 05OpenAPI schema for Dify

Use cases

  1. 01Review Nutanix cluster basics
  2. 02Inspect VM names and resource configuration
  3. 03Expose Nutanix data as Dify custom tools

MCP support

The project describes itself as an MCP server and provides cluster and VM information endpoints, with getClusters and getVms tools described for Dify registration. The README identifies it as an MVP prototype and advises against production use.

#nutanix#mcp-server#fastapi

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

nutanix-mcp-server

Nutanix Prism Central と連携してクラスタ・仮想マシン情報を取得する MCP (Model Context Protocol) サーバーの FastAPI 実装

概要

本プロジェクトは、Nutanix環境を対象とした Model Context Protocol (MCP) サーバーの Minimum Viable Product (MVP) を実装するものです。主な目的は、FastAPI を利用して Nutanix Prism Central からクラスタ情報を取得することにあり、本 MVP は将来的な機能拡張（追加の情報取得、モデル操作、セキュリティ強化など）の基盤となります。 プロトタイプのため本番環境では利用しないでください。

動作環境

  • OS: macOS, Linux, Windows（WSL2含む）
  • Python: 3.12 以上推奨
  • pip: 23.x 以上推奨
  • Nutanix Prism Central API バージョン: v4.0.2（Cluster Management API）
  • Nutanix Prism Central API バージョン: v4.0（Virtual Machine Management 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
# VERIFY_SSL="false"

.env ファイルはプロジェクトルートに配置してください。.gitignore によりコミット対象から除外されます。

  • SSL 検証について： 現在、自己署名証明書に対応するため、証明書検証を無効（verify=False）にしています。運用環境では、適切な SSL 検証を実施してください。 .env 内の値はすべて文字列として扱われます。VERIFY_SSL を使用する際は "false" のようにクオートで囲むか、コード側で文字列をブール型に変換する処理が必要です。
サーバーの起動

uvicorn を使用してMCPサーバーを起動します：

uvicorn app:app --reload

MCPサーバーは http://127.0.0.1:8000 で起動します。

API エンドポイントの確認

  • Swagger UI： ブラウザで http://127.0.0.1:8000/docs にアクセスすると、API ドキュメントを確認・テストできます。

  • curl を利用して確認：

    • /clusters: Nutanix クラスタの基本情報（UUID、クラスタ名、ノード構成など）を返します。
    • /vms: Prism Central 上の仮想マシン情報（名前、vCPU、メモリ構成など）を返します。
    curl -v http://127.0.0.1:8000/clusters
curl -v http://127.0.0.1:8000/vms
Dify 連携について

本リポジトリには、Dify のカスタムツールとして MCP サーバーを登録するための OpenAPI スキーマファイル dify-openapi-schema.json が含まれています。

Dify 上でこのスキーマを使ってカスタムツールを登録し、エージェントにそのツールを割り当てることで、自然言語で Nutanix クラスタ情報や仮想マシン情報を取得・確認することができます。

  1. Dify の管理画面で「ツール」>「カスタムツール」からNutanix MCP Serverを作成します。
  2. dify-openapi-schema.json で定義されているスキーマを貼り付けます。
  3. 利用可能なツールにgetClustersとgetVmsが表示され、テストが正常に動くことを確認します。
  4. 新しいエージェントを作成し、ツールとして MCP サーバーを登録したカスタムツールを指定します。
  5. エージェント画面で「クラスタの情報を教えて」など自然言語で問いかけると、MCP サーバーに問い合わせて結果を返してくれます。

接続アドレスについて： Dify を Podman 上で動作させている場合、dify-openapi-schema.jsonを変更せずにMCP サーバーのアドレスとして http://host.containers.internal:8000 を利用可能です。
Docker など他の環境では http://host.docker.internal:8000など適切なホスト名・IP アドレスに読み替えてください。

更新履歴

  • 2025-04-18: バージョン v0.1.0 初期リリース。
    • /clusters および /vms エンドポイントを実装。
    • Nutanix Prism Central との連携。
    • FastAPI による REST API サーバー。
    • .env による認証情報および接続先の外部化。
    • OpenAPI スキーマを Dify 連携用に対応。

貢献方法

貢献は大歓迎です。機能改善やバグ修正について Pull Request を送信してください。大きな変更を行う前には、まず Issue を立てて議論してください。

ライセンス

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

将来の拡張予定

  • 仮想マシンの詳細情報（NIC / ディスク構成）の追加
  • クラスタ単体の詳細表示エンドポイントの実装
  • Nutanix API vmm の統合による操作系 API の導入（仮想マシンの起動/停止など）
  • Dify からの対話操作支援

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.