nutanix-mcp-server

nutanix-mcp-server

site icon
2025.04.17 0
PythonNutanix 集成集群管理虚拟机管理其它
nutanix-mcp-server-jp 是一个基于 FastAPI 实现的 MCP (Model Context Protocol) 服务器,主要用于与 Nutanix Prism Central 集成,获取集群和虚拟机信息。该项目是 Nutanix 环境的 MVP (Minimum Viable Product) 实现,旨在为未来的功能扩展(如更多信息获取、模型操作、安全性增强等)提供基础。目前为原型阶段,不建议在生产环境中使用。
View on GitHub

Overview

基本能力

产品定位

nutanix-mcp-server-jp 是一个用于与 Nutanix Prism Central 集成的 MCP 服务器,提供集群和虚拟机信息的获取功能。

核心功能

  • 通过 FastAPI 实现 REST API 服务器。
  • 提供 /clusters/vms 两个主要端点,分别用于获取 Nutanix 集群的基本信息和虚拟机信息。
  • 支持与 Dify 平台集成,通过自然语言查询获取 Nutanix 环境信息。

适用场景

  • 需要快速获取 Nutanix 集群和虚拟机信息的开发环境。
  • 与 Dify 平台集成,通过自然语言查询 Nutanix 环境信息。
  • 作为未来功能扩展的基础原型。

工具列表

  • Dify 集成工具:通过 OpenAPI 模式文件 dify-openapi-schema.json 在 Dify 平台上注册自定义工具,支持自然语言查询集群和虚拟机信息。

常见问题解答

  • SSL 验证:当前默认禁用 SSL 验证(verify=False),适用于自签名证书环境。生产环境建议启用适当的 SSL 验证。
  • Dify 连接地址:在 Podman 环境中可使用 http://host.containers.internal:8000,Docker 环境中可使用 http://host.docker.internal:8000

使用教程

使用依赖

  • 操作系统:macOS, Linux, Windows(含 WSL2)。
  • Python:3.12 及以上版本。
  • pip:23.x 及以上版本。
  • Nutanix Prism Central API:Cluster Management API v4.0.2,Virtual Machine Management API v4.0。

安装教程

# 克隆仓库
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

调试方式

# 启动服务器
uvicorn app:app --reload

# 测试 API 端点
curl -v http://127.0.0.1:8000/clusters
curl -v http://127.0.0.1:8000/vms

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。