Nutanix MCP Server Jp

🚀 nutanix-mcp-server

本項目是 Nutanix Prism Central 與 Nutanix 集群及虛擬機信息交互的 MCP（模型上下文協議）服務器的 FastAPI 實現，可從 Nutanix Prism Central 獲取集群信息，為後續功能擴展奠定基礎。

🚀 快速開始

本項目旨在實現針對 Nutanix 環境的 Model Context Protocol (MCP) 服務器的最小可行產品（MVP）。主要目標是利用 FastAPI 從 Nutanix Prism Central 獲取集群信息。此 MVP 將作為未來功能擴展的基礎，如獲取更多類型的信息、執行模型操作以及加強安全性等。

⚠️ 重要提示 由於本項目為原型開發，請勿在生產環境中使用。

📦 安裝指南

運行環境

• 操作系統: 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 提交功能改進或 bug 修復。重大變更前，請先創建 Issue 進行討論。

未來擴展計劃

• 添加虛擬機的詳細信息（如 NIC 和磁盤配置）
• 實現按集群單獨顯示詳細信息的接口
• 集成 Nutanix API vmm，引入操作類 API（如虛擬機啟動/停止等）
• 支持與 Dify 的交互式操作

📄 許可證

本項目遵循 LICENSE 文件中的條件進行許可。