项目简介

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 接口。

安装步骤

  1. 克隆仓库

    git clone https://github.com/thunderboltsid/mcp-nutanix.git
    cd mcp-nutanix
  2. 构建服务器 确保您已安装 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',即标准输入输出。

基本使用方法

  1. 启动服务器 在终端中运行编译后的服务器程序:

    ./bin/mcp-nutanix

    服务器启动后,会等待 MCP 客户端的连接和请求。

  2. 客户端交互 使用 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 连接凭据。

信息

分类

商业系统