项目简介
MCP Nutanix Server 是一个实验性的 Model Context Protocol (MCP) 服务器,旨在通过大型语言模型 (LLM) 与 Nutanix Prism Central API 进行交互。它允许 LLM 以标准化的方式访问 Nutanix Prism Central 的资源和功能。
请注意: 这是一个实验性项目,并非 Nutanix 官方产品,不提供任何形式的支持或保证,请您自行承担使用风险。
主要功能点
- 资源访问: 提供对 Nutanix Prism Central 中各种资源(如虚拟机、集群、主机、镜像、子网等)的访问能力。
- 工具调用: 注册并提供工具,允许 LLM 列出和查询 Nutanix 资源信息。
- Prompt 模板: 包含用于设置 Prism Central 连接凭据的 Prompt 模板,方便用户配置服务器。
- 标准化接口: 基于 MCP 协议与客户端通信,提供标准的 JSON-RPC 接口。
安装步骤
-
克隆仓库
git clone https://github.com/thunderboltsid/mcp-nutanix.git cd mcp-nutanix -
构建服务器 确保您已安装 Go 1.23 或更高版本,以及 'make' 和 'go fmt' 工具。
make build构建成功后,可执行文件 'mcp-nutanix' 将在 'bin/' 目录下生成。
服务器配置
MCP 客户端需要配置以下 JSON 信息以连接到 MCP Nutanix Server:
{ "serverName": "Prism Central", "command": "./bin/mcp-nutanix", "args": [], "transport": "stdio" }
配置参数说明:
- 'serverName': 服务器名称,这里设置为 "Prism Central"。
- 'command': MCP Nutanix Server 的启动命令,指向编译生成的可执行文件。 请根据您的实际路径调整。
- 'args': 启动参数,本服务器无需额外启动参数,因此为空数组 '[]'。
- 'transport': 传输协议,这里使用 'stdio',即标准输入输出。
基本使用方法
-
启动服务器 在终端中运行编译后的服务器程序:
./bin/mcp-nutanix服务器启动后,会等待 MCP 客户端的连接和请求。
-
客户端交互 使用 MCP 客户端连接到服务器后,您可以通过以下方式与 Nutanix Prism Central 交互:
-
设置凭据 (Prompt): 使用 'credentials' Prompt 设置 Prism Central 的连接信息。客户端会提示您输入 Prism Central 的终端地址 (endpoint)、用户名 (username)、密码 (password) 以及是否跳过 TLS 验证 (insecure)。
-
列出资源 (Tool): 使用以下工具名称列出不同类型的 Nutanix 资源:
- 'vms': 虚拟机列表
- 'clusters': 集群列表
- 'hosts': 主机列表
- 'images': 镜像列表
- 'subnets': 子网列表
- ... (更多资源类型请参考仓库代码)
例如,在 MCP 客户端中调用 'vms' 工具,服务器将返回 JSON 格式的虚拟机列表。
-
访问资源详情 (Resource): 使用资源 URI 访问特定资源的详细信息。资源 URI 的格式为 '资源类型://UUID',例如:
- 'vm://<虚拟机UUID>'
- 'cluster://<集群UUID>'
- 'host://<主机UUID>'
例如,请求 'vm://b7816400-16c5-47c7-9fcc-474e39594ad5' 资源,服务器将返回 UUID 为 'b7816400-16c5-47c7-9fcc-474e39594ad5' 的虚拟机的详细 JSON 信息。
-
注意: 请确保在首次使用工具和资源访问功能前,先使用 'credentials' Prompt 设置正确的 Prism Central 连接凭据。
信息
分类
商业系统