JinDaGe - mcp-nutanix MCP Details

article

README

🚀 MCP Nutanix中国区开源项目介绍

本项目是中国区实验性质的开源项目，旨在探索Model Context Protocol框架在Go语言中的应用能力。它能让大语言模型（LLMs）与Nutanix Prism Central交互，实现资源的列出和详细信息获取等功能。

⚠️ 注意事项

⚠️ 重要提示

此项目为中国区实验性质的开源项目，具有以下特点：

非官方产品：不是Nutanix公司的官方产品或工具。

无支持保证：未得到Nutanix的支持、认可或维护。

不适合生产环境：不适合用于正式的生产场景。

按现状提供：没有任何担保或保证。

风险自担：作者不对使用此代码可能产生的任何问题、损害或故障负责。

✨ 主要特性

此MCP服务器允许大语言模型（LLMs）通过与Nutanix Prism Central的交互实现以下功能：

使用用户凭证连接到Prism Central实例。
列出各种资源（虚拟机、集群、主机等）。
通过基于URI的访问获取特定资源的详细信息。

该实现使用了Prism Go客户端与Prism Central通信，并使用MCP Go库实现了Model Context Protocol。

🚀 快速开始

📦 安装指南

先决条件

Go语言版本1.23或更高。
访问Nutanix Prism Central实例的权限。
建议使用make和go fmt等工具进行构建。

构建项目

# 克隆仓库
git clone https://github.com/thunderboltsid/mcp-nutanix.git
cd mcp-nutanix

# 构建MCP服务器
make build

运行服务器

./bin/mcp-nutanix

运行后，系统将提示输入Prism Central的凭证信息。

💻 使用示例

基础用法

一旦MCP服务器连接到您的Prism Central实例并正常运行，大语言模型可以通过MCP协议与其交互。

资源列表

要列出资源，请使用以下命令：

vms
clusters
hosts
images
subnets

大语言模型将接收到JSON格式的资源列表，并可对其进行解析和分析。

资源访问

要访问特定资源，请使用基于URI的语法：

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

大语言模型将接收到指定资源的详细JSON信息。

📚 详细文档

开发指南

项目结构

mcp-nutanix/
├── bin/                  # 编译后的二进制文件存放位置
├── internal/             # 内部组件包
│   ├── client/           # Prism Central客户端处理逻辑
│   ├── codegen/          # 代码生成工具
│   └── json/             # JSON数据处理辅助函数
├── pkg/                  # 核心功能组件
│   ├── prompts/          # MCP协议提示语实现
│   ├── resources/        # 资源处理逻辑
│   └── tools/            # 工具集处理逻辑
└── Makefile              # 构建和命令工具文件

代码生成

项目使用代码生成技术来创建资源和工具处理模块。要更新这些内容：

make generate

局限性说明

响应大小受MCP协议限制。
对于返回数据量较大的资源可能引发错误。
当前版本不支持分页功能。
仅支持读取操作，暂未实现创建、更新或删除功能。

mcp-nutanix