项目简介

Novita MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端应用。它作为大型语言模型（LLM）客户端（如 Claude Desktop 或 Cursor）与 Novita AI 平台之间的桥梁，允许您通过自然语言指令管理 Novita AI 上的各种云资源，特别是 GPU 实例。

主要功能点

该服务器将 Novita AI 平台的资源管理操作封装为 LLM 可理解和调用的 工具。目前主要支持以下资源的自动化管理：

• 集群/地域管理: 查看可用的计算集群列表。
• 产品管理: 查看不同地域可用的 GPU 实例产品列表。
• GPU 实例管理: 对您的 GPU 实例执行多种操作，包括：
  • 列出所有实例
  • 获取特定实例详情
  • 创建新实例
  • 启动实例
  • 停止实例
  • 删除实例
  • 重启实例
• 模板管理: 列出、获取、创建和删除实例部署模板。
• 容器镜像仓库认证管理: 列出、创建和删除私有镜像仓库的认证信息。
• 网络存储管理: 列出、创建、更新和删除网络存储卷。

安装步骤

您可以通过 npm 包管理器全局安装此服务器：

1. 确保您已安装 Node.js 环境。

2. 打开终端或命令行工具。

3. 运行以下命令进行全局安装：

   npm install -g @novitalabs/novita-mcp-server
   

安装完成后，服务器即可通过命令 'npx @novitalabs/novita-mcp-server' 启动。

服务器配置（供 MCP 客户端使用）

MCP 服务器需要被 MCP 客户端（如 Claude Desktop, Cursor）启动和连接。您需要在您的 MCP 客户端中配置该服务器的信息。配置通常是一个 JSON 格式的对象，指示客户端如何找到并运行服务器。

对于 'novita-mcp-server'，核心配置信息如下：

• 服务器名称 (name): 用于标识该服务器的唯一名称，例如 '@novitalabs/novita-mcp-server'。
• 启动命令 (command): 告诉客户端用于启动服务器的可执行文件或命令，例如 'npx'。
• 命令参数 (args): 传递给启动命令的参数，用于指定要运行的具体脚本或包，例如 '["-y", "@novitalabs/novita-mcp-server"]'。
• 环境变量 (env): 服务器运行时需要的环境变量。非常重要，您必须在此处提供您的 Novita AI API Key。例如设置环境变量 'NOVITA_API_KEY' 的值为您的实际 API Key。请从 Novita AI 网站获取您的 API Key。

请参考您的 MCP 客户端的具体文档，将上述信息填入其 MCP 服务器配置界面或文件中。

基本使用方法

正确安装并配置服务器到您的 MCP 客户端后，您就可以通过在客户端的对话界面中输入自然语言指令来调用服务器提供的工具。LLM 会解析您的意图，识别出需要调用的工具及其参数，并通过 MCP 协议请求服务器执行。

例如，您可以尝试以下指令（具体对话体验取决于您的 LLM 客户端能力）：

• 'List all the Novita clusters' (列出所有 Novita 集群)
• 'List all my running Novita GPU instances' (列出我所有正在运行的 Novita GPU 实例)
• 'Create a new Novita GPU instance with name 'my-gpu-server', product 'A100', 1 GPU, and 60GB disk using a PyTorch image.' (创建一个名为 'my-gpu-server' 的新 GPU 实例，使用 A100 产品，1块GPU，60GB磁盘，并使用 PyTorch 镜像。)

服务器会执行相应的 Novita AI API 调用，并将结果返回给客户端，最终通过 LLM 呈现给您。