Massed Compute Mcp

Massed Compute MCP 服务

一个模型上下文协议服务，让 AI 助手——Claude、Cursor、Codex、ChatGPT 和其他兼容 MCP 的客户端——与您的 Massed Compute 账户交互：浏览 GPU 库存、启动和管理 VM、审查账单、查找设置方案。

目录

• 概述
• 安装
• 验证连接
• CLI 参考
• 密钥解析
• 资源
• 许可证

概述

此仓库发布的软件包是对 https://vm.massedcompute.com/api/mcp 上公开 MCP 端点的原样代理——不添加任何功能。每条 JSON-RPC 消息（initialize、tools/list、tools/call、resources/list、resources/read、ping，等等）都会原样转发，并在请求头中注入您存储的 API 密钥作为 Bearer 凭据；响应也会原样返回。整个过程中不会添加、重命名、筛选或改写任何内容：

• 工具目录由托管端点提供。 工具、资源、架构和描述均来自实时端点——上游发布新功能（例如设置方案）时，本地软件包不会过时。
• 安全性由托管端点负责。 密钥范围的强制执行（只读密钥会隐藏破坏性工具）和凭据脱敏都在服务端完成，对所有客户端一视同仁。
• 本地软件包添加的内容正是 stdio 客户端所需的功能：stdio↔可流式传输的 HTTP 桥接、按操作系统惯例存储 API 密钥（POSIX 上权限为 0600），以及通过 init 一次性配置客户端。

为仅用于分析的助手创建只读密钥，端点便会在调用时拒绝破坏性工具调用（启动、重启、终止、更改 SSH 密钥）。支持 Claude Code、Claude Desktop、Cursor 和 Codex。运行 massed-compute-mcp tools 可打印实时工具目录——GPU 库存、VM 镜像、实例生命周期、优惠券、账单、SSH 密钥和设置方案。

除原始工具外，Massed Compute 还发布了 Agent Skills——用于 GPU 选择和成本审计等常见操作的 Markdown 工作流模板。完整文档请参阅 vm-docs.massedcompute.com/docs/category/mcp。

安装

步骤 1. 获取 API 密钥

打开 vm.massedcompute.com/settings/api，创建密钥（仅用于分析的助手请选择只读密钥；如需允许启动／重启／终止／更改 SSH 密钥，请选择完全访问权限），然后复制密钥。

步骤 2. 选择安装方式

• 托管端点 — 将客户端指向可流式传输的 HTTP URL，无需安装
• 本地 CLI — 在您的计算机上运行，密钥存储在操作系统配置目录中

托管端点

本地软件包会原样代理此端点，因此让客户端直接连接该端点，即可使用完全相同的工具目录，无需安装任何内容。选择适用于您客户端的配置片段：

Claude Code

claude mcp add --transport http massed-compute \
  https://vm.massedcompute.com/api/mcp \
  --header "Authorization: Bearer MC_TOKEN"

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "massed-compute": {
      "url": "https://vm.massedcompute.com/api/mcp",
      "headers": { "Authorization": "Bearer MC_TOKEN" }
    }
  }
}

Codex — ~/.codex/config.toml

[mcp_servers.massed-compute]
url = "https://vm.massedcompute.com/api/mcp"
bearer_token_env_var = "MC_TOKEN"
enabled = true

Claude Desktop

Claude Desktop 目前尚不支持可流式传输的 HTTP MCP，因此请使用 mcp-remote 作为 stdio↔HTTP 桥接工具。配置文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "massed-compute": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://vm.massedcompute.com/api/mcp",
        "--header", "Authorization: Bearer MC_TOKEN"
      ]
    }
  }
}

本地命令行工具

通过你偏好的生态系统安装：

npm install -g massed-compute-mcp     # Node >= 20
# or
pip install massed-compute-mcp        # Python >= 3.10
# or
uv tool install massed-compute-mcp    # fast Python install via uv

运行一次性设置：

massed-compute-mcp init

init 会提示输入密钥、在上游验证密钥、以 0600（POSIX）权限存储密钥、检测已安装的 MCP 客户端（Claude Code、Cursor、Claude Desktop、Codex），并询问是否为每个客户端接入工具。在编辑任何客户端配置前，都会创建带时间戳的备份。重启已接入的客户端以加载工具。

配置文件位置：

• Linux：$XDG_CONFIG_HOME/massed-compute/config.json（否则使用 ~/.config/...）
• macOS：~/Library/Application Support/massed-compute/config.json
• Windows：%APPDATA%\massed-compute\config.json

非交互模式（CI / 脚本）：

# Key from env, auto-wire every detected client
MASSED_COMPUTE_API_KEY=<your-key> massed-compute-mcp init --yes

# Key from a file, wire only specific clients
massed-compute-mcp init --token-file ~/keys/mc --yes --clients claude-code,cursor

# Store the key only; don't touch any client config
massed-compute-mcp init --yes --no-install-clients

稍后添加或移除客户端：

massed-compute-mcp install-client cursor       # claude-desktop | codex | claude-code
massed-compute-mcp uninstall-client cursor

install-client 具有幂等性——如果条目已匹配，重复运行不会执行任何操作，也不会输出内容。

验证连接

massed-compute-mcp doctor

doctor 会确认存储的密钥仍然有效、打印工具目录，并显示尚未自动接入的客户端可直接复制粘贴的代码片段。或者直接询问你的助手 “Validate my Massed Compute API key.”——如果返回 { message: "Valid Token" }，则表示接入成功。

命令行工具参考

命令	功能
massed-compute-mcp （无参数）	通过 stdio 运行 MCP 服务
massed-compute-mcp init	首次设置：提示输入、验证、存储并接入客户端
massed-compute-mcp doctor	验证存储的密钥并打印客户端代码片段
massed-compute-mcp install-client <id>	接入单个客户端（claude-code、cursor、claude-desktop、codex）
massed-compute-mcp uninstall-client <id>	从客户端配置中移除我们的条目
massed-compute-mcp config show	打印解析后的配置路径、掩码密钥和解析链
massed-compute-mcp logout	删除存储的 API 密钥
massed-compute-mcp tools [--json]	从托管端点获取并打印实时工具目录
massed-compute-mcp version	打印版本

密钥解析

服务启动时，会使用第一个提供密钥的来源：

1. --token <value> 命令行标志
2. --token-file <path> 命令行标志（读取首行并去除首尾空白）
3. MASSED_COMPUTE_API_KEY 环境变量
4. init 写入的存储配置文件

如果以上来源均未设置，服务会以非零状态码退出，并提示运行 massed-compute-mcp init。使用 MASSED_COMPUTE_API_BASE_URL 覆盖上游地址（默认为 https://vm.massedcompute.com）。

资源

• 完整 MCP 文档
• Massed Compute API 参考
• Massed Compute 控制台
• Model Context Protocol 规范

许可证

MIT——参见 LICENSE。