🚀 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 文件中的条件进行许可。