ComputeNexa

ComputeNexa MCP 服务

让你的 AI 助手在 ComputeNexa 上查找、启动和停止专属 GPU。询问它 “有哪些显存为 48 GB 或以上且有货的 GPU？”、“启动最便宜的一台，并运行 Data Science 两小时” 或 “停止它”：它会使用你团队的 API 密钥，显示每次启动的费用，并且只有在你同意后才会花费资金。

支持 Claude Desktop、Claude Code、Cursor、VS Code 以及其他支持 Model Context Protocol 的助手。它运行在你的计算机上，并与 ComputeNexa API 通信； 你的密钥会保存在你自己的设置中。

设置

1. 在 ComputeNexa 控制面板中，打开 API keys 并创建密钥：
   • 仅查看：浏览 GPU、机器和支出；
   • 启动和停止：还可启动、延长机器运行时间并停止机器。
2. 安装 uv（它会通过 uvx 运行服务，无需单独安装）。
3. 将服务添加到你的助手中（见下文），并将你的密钥设为 CNX_API_KEY。

Claude Code

claude mcp add --env CNX_API_KEY=cnxk_... --transport stdio computenexa -- uvx computenexa-mcp

添加 --scope user，即可在每个项目中使用。

Claude Desktop

设置 → Developer → 编辑配置（claude_desktop_config.json）：

{
  "mcpServers": {
    "computenexa": {
      "command": "uvx",
      "args": ["computenexa-mcp"],
      "env": { "CNX_API_KEY": "cnxk_..." }
    }
  }
}

Cursor

~/.cursor/mcp.json（每个项目）或 .cursor/mcp.json（单个项目）：使用与 Claude Desktop 相同的 mcpServers 条目。

VS Code

.vscode/mcp.json；VS Code 会提示你输入一次密钥，并将其保存在文件之外：

{
  "inputs": [
    { "type": "promptString", "id": "cnx-key", "description": "ComputeNexa API key", "password": true }
  ],
  "servers": {
    "computenexa": {
      "type": "stdio",
      "command": "uvx",
      "args": ["computenexa-mcp"],
      "env": { "CNX_API_KEY": "${input:cnx-key}" }
    }
  }
}

功能

工具	功能	密钥
whoami	你的邮箱、团队、余额、GPU 限额和密钥权限	任意
list_gpus	按价格从低到高列出 GPU 的实时价格和库存；可按应用、区域、显存筛选	任意
list_apps	GPU 启动时附带的应用、应用中的模型，以及已安装内容	任意
list_machines · get_machine	你的机器；连接方式（SSH、浏览器应用、API 或端点地址）	任意
get_usage · list_receipts	支出和 GPU 小时数；已结束的会话及其费用	任意
list_projects · list_endpoints	已保存的项目；端点及其指向的机器	任意
launch_machine	启动 GPU（先报价，得到你的同意后再启动）	启动和停止
extend_machine	延长运行时间（先报价）	启动和停止
set_keep_running	自动续订机器，直到停止（先报价）	启动和停止
stop_machine	立即停止机器；未使用的时间会退款	启动和停止
create_endpoint · get_endpoint_key	自有服务器的固定 HTTPS 地址；其密钥	启动和停止

仅查看密钥只能调用读取工具（前六行）。

安全

• 未经你的同意，不会产生任何费用。 launch_machine、extend_machine 和 set_keep_running 会先返回报价， 例如 “NVIDIA RTX A6000 搭配 datascience 应用，运行 2 h：立即收取 $1.44（$0.72/h）；如果提前停止，会退还未使用时间。” 只有再次调用并设置 confirm=true，且提供报价中的总金额后，操作才会继续；如果期间价格上涨，操作会被拒绝。
• 单次调用设有限额： 启动、延长运行时间或自动续订的费用超过 $25 时，操作会被拒绝。可通过服务 env 中的 CNX_MCP_MAX_LAUNCH_USD（以美元计）更改此限额。你的团队 GPU 限额和预付余额仍会另外生效。
• 工具结果中绝不会显示你的 API 密钥。 端点密钥只会在创建端点或查询其密钥时显示。
• 会花费资金或停止机器的工具都会明确标记，以便你的助手在使用前征求你的同意。

设置项

变量
CNX_API_KEY	必填。ComputeNexa API 密钥（cnxk_…）
CNX_MCP_MAX_LAUNCH_USD	单次调用最多可花费的金额，以美元计。默认值为 25
CNX_API_URL	仅用于针对其他 ComputeNexa API 进行测试

Develop

uv sync
uv run pytest
uv run ruff check src tests

Built on the ComputeNexa Python SDK and the official MCP Python SDK.

Questions: [email protected] · Security issues: see SECURITY.md.