MCP Nutanix

MCP Nutanix

一个通过大语言模型（LLM）与 Nutanix Prism Central API 交互的模型上下文协议（MCP）服务。

⚠️ 免责声明

这是一个实验性项目

本项目是个人项目，旨在探索 Go 中模型上下文协议框架的功能。它：

• 不是 Nutanix 的官方产品或工具
• 不受 Nutanix 支持、认可或维护
• 不适用于生产环境
• 按原样提供，不提供任何保证或担保

风险自负：作者不对使用此代码可能导致的任何问题、损害或服务中断承担责任。

概述

此 MCP 服务允许大模型通过以下方式与 Nutanix Prism Central 交互：

1. 使用用户凭据连接到 Prism Central 实例
2. 列出各种资源（VM、集群、主机等）
3. 通过基于 URI 的访问方式获取特定资源的详细信息

此实现使用 Prism Go Client 与 Prism Central 通信，并使用 MCP Go library 实现模型上下文协议。

开始使用

先决条件

• Go 1.23 或更高版本
• 可访问 Nutanix Prism Central 实例
• 用于构建的 make 和 go fmt 等工具

构建

# Clone the repository
git clone https://github.com/thunderboltsid/mcp-nutanix.git
cd mcp-nutanix

# Build the MCP server
make build

凭据配置

此服务支持两种凭据方式：

1. 交互式凭据（默认）——可通过 MCP 提示词与 Claude 配合使用
2. 静态凭据——Cursor 等不支持交互式提示词的工具必须使用此方式

MCP 客户端配置

要在 MCP 客户端中使用此服务，需要配置客户端以连接到该服务。

Claude Desktop/Code

创建或更新 ~/.anthropic/claude_desktop.json：

{
  "mcpServers": {
    "nutanix": {
      "command": "/path/to/mcp-nutanix"
    }
  }
}

首次使用此服务时，Claude 会提示你输入凭据。

Cursor

由于 Cursor 不支持交互式提示词，你需要通过环境变量提供静态凭据。

创建或更新 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "nutanix": {
      "command": "/path/to/mcp-nutanix",
      "env": {
        "NUTANIX_ENDPOINT": "your-prism-central-ip-or-hostname",
        "NUTANIX_USERNAME": "your-username", 
        "NUTANIX_PASSWORD": "your-password",
        "NUTANIX_INSECURE": "true"
      }
    }
  }
}

环境变量：

• NUTANIX_ENDPOINT - Prism Central IP 地址或主机名（必需）
• NUTANIX_USERNAME - API 用户名（必需）
• NUTANIX_PASSWORD - API 密码（必需）
• NUTANIX_INSECURE - 对自签名证书设置为 "true"（可选）

其他 MCP 客户端

此服务遵循标准 MCP 协议，应可与任何支持 stdio 传输的 MCP 客户端配合使用。配置说明请参阅客户端文档。

用法

在客户端中配置 MCP 服务并连接到 Prism Central 实例后，大模型即可通过 MCP 协议与其交互。

列出资源

要列出资源，请使用相应的工具：

vms
clusters
hosts
images
subnets

大模型将收到可供解析和分析的资源 JSON 列表。

访问资源

要访问特定资源，请使用资源 URI：

vm://{uuid}
cluster://{uuid}
host://{uuid}

大模型将收到有关特定资源的详细 JSON 信息。

开发

项目结构

mcp-nutanix/
├── bin/                  # Compiled binaries
├── internal/             # Internal packages
│   ├── client/           # Prism Central client handling
│   ├── codegen/          # Code generation utilities
│   └── json/             # JSON helpers
├── pkg/                  # components
│   ├── prompts/          # MCP prompt implementations
│   ├── resources/        # Resource handlers
│   └── tools/            # Tool handlers
└── Makefile              # Build and utility commands

代码生成

此项目使用代码生成来创建资源和工具处理程序。要更新这些内容：

make generate

限制

• 响应大小受 MCP 协议限制
• 某些响应较大的资源可能会导致错误
• 当前实现不支持分页
• 仅支持读取操作，不支持创建、更新或删除

许可证

此项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

致谢

• 感谢 Nutanix 创建 Prism API
• 感谢 Mark3Labs 提供 MCP Go library
• 感谢 Nutanix Cloud Native 提供 Prism Go Client

贡献

这是一个没有正式贡献流程的实验性项目。欢迎提交问题或拉取请求。