Massed Compute MCP

Explora el inventario de GPU, lanza y administra máquinas virtuales, y audita la facturación en Massed Compute desde cualquier agente de IA.

GitHub

Prueba este MCPPatrocinado

Documentación

Massed Compute MCP Server

Un servidor de Model Context Protocol que permite a los asistentes de IA — Claude, Cursor, Codex, ChatGPT y otros clientes compatibles con MCP — interactuar con tu cuenta de Massed Compute: explorar el inventario de GPU, lanzar y gestionar VMs, auditar facturación y descubrir recetas de configuración.

Descripción general

Los paquetes publicados desde este repositorio son un proxy verbatim del endpoint público de MCP en https://vm.massedcompute.com/api/mcp — cero superficie añadida. Cada mensaje JSON-RPC (initialize, tools/list, tools/call, resources/list, resources/read, ping, …) se reenvía sin cambios con tu clave de API almacenada inyectada como cabecera Bearer, y las respuestas vuelven sin cambios. Nada se añade, renombra, filtra o reescribe en el camino:

El endpoint alojado es dueño del catálogo. Las herramientas, recursos, esquemas y descripciones provienen del endpoint en vivo — el paquete local nunca queda obsoleto cuando nuevas capacidades (como recetas de configuración) se publican upstream.
El endpoint alojado es dueño de la seguridad. La aplicación del alcance de claves (las claves de solo lectura ocultan herramientas destructivas) y la redacción de credenciales ocurren en el servidor, de forma idéntica para cada cliente.
Lo que el paquete local añade es exactamente lo que un cliente stdio necesita: un puente stdio↔streamable-HTTP, almacenamiento convencional del sistema operativo para tu clave de API (0600 en POSIX) y configuración de cliente en un solo paso mediante init.

Emite una clave de solo lectura para asistentes de solo análisis y el endpoint rechazará las llamadas a herramientas destructivas (lanzar, reiniciar, terminar, cambios de claves SSH) en el momento de la llamada. Funciona con Claude Code, Claude Desktop, Cursor y Codex. Ejecuta massed-compute-mcp tools para imprimir el catálogo en vivo — inventario de GPU, imágenes de VM, ciclo de vida de instancias, cupones, facturación, claves SSH y recetas de configuración.

Más allá de las herramientas crudas, Massed Compute publica Agent Skills — plantillas de flujo de trabajo en markdown para operaciones comunes como selección de GPU y auditoría de costes. Documentación completa en vm-docs.massedcompute.com/docs/category/mcp.

Instalación

Paso 1. Obtén tu clave de API

Abre vm.massedcompute.com/settings/api, crea una clave (de solo lectura para asistentes de solo análisis; de acceso completo para permitir lanzar / reiniciar / terminar / cambios de claves SSH), cópiala.

Paso 2. Elige una vía de instalación

Endpoint alojado — apunta tu cliente a la URL streamable-HTTP, instalación cero
CLI local — se ejecuta en tu máquina, clave almacenada en tu directorio de configuración del SO

Endpoint alojado

Los paquetes locales hacen de proxy de este endpoint verbatim, así que apuntar tu cliente directamente a él te da el catálogo idéntico sin nada que instalar. Elige el fragmento para tu cliente:

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 aún no habla streamable-HTTP MCP, así que usa mcp-remote como puente stdio↔HTTP. Configuración en ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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"
      ]
    }
  }
}

CLI local

Instala mediante el ecosistema que prefieras:

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

Ejecuta la configuración en un solo paso:

massed-compute-mcp init

init solicita la clave, la valida upstream, la almacena en 0600 (POSIX), detecta los clientes MCP instalados (Claude Code, Cursor, Claude Desktop, Codex) y ofrece configurar cada uno. Se realiza una copia de seguridad con marca de tiempo antes de cualquier edición de cliente. Reinicia los clientes configurados para que carguen las herramientas.

Ubicación del archivo de configuración:

Linux: $XDG_CONFIG_HOME/massed-compute/config.json (con respaldo en ~/.config/...)
macOS: ~/Library/Application Support/massed-compute/config.json
Windows: %APPDATA%\massed-compute\config.json

No interactivo (CI / scripts):

# 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

Añade o elimina un cliente más tarde:

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

install-client es idempotente — volver a ejecutarlo cuando la entrada ya coincide es un no-op silencioso.

Verificación de la conexión

massed-compute-mcp doctor

doctor confirma que la clave almacenada sigue funcionando, imprime el catálogo de herramientas y muestra fragmentos copiables para cualquier cliente que no hayas configurado automáticamente. O simplemente pregunta a tu asistente "Valida mi clave de API de Massed Compute." — una respuesta { message: "Valid Token" } confirma la configuración.

Referencia de CLI

Comando	Qué hace
`massed-compute-mcp` (sin argumentos)	Ejecuta el servidor MCP sobre stdio
`massed-compute-mcp init`	Configuración inicial: solicitar, validar, almacenar, configurar clientes
`massed-compute-mcp doctor`	Verifica la clave almacenada e imprime fragmentos de cliente
`massed-compute-mcp install-client <id>`	Configura un solo cliente (`claude-code`, `cursor`, `claude-desktop`, `codex`)
`massed-compute-mcp uninstall-client <id>`	Elimina nuestra entrada de la configuración de un cliente
`massed-compute-mcp config show`	Imprime la ruta de configuración resuelta, la clave enmascarada y la cadena de resolución
`massed-compute-mcp logout`	Elimina la clave de API almacenada
`massed-compute-mcp tools [--json]`	Obtiene e imprime el catálogo de herramientas en vivo desde el endpoint alojado
`massed-compute-mcp version`	Imprime la versión

Resolución de claves

Cuando el servidor se inicia, la clave de API se toma de la primera fuente que la proporcione:

Bandera de CLI --token <value>
Bandera de CLI --token-file <path> (primera línea, recortada)
Variable de entorno MASSED_COMPUTE_API_KEY
Archivo de configuración almacenado escrito por init

Si ninguna de estas está configurada, el servidor sale con código distinto de cero y una referencia a massed-compute-mcp init. Sobrescribe el upstream con MASSED_COMPUTE_API_BASE_URL (por defecto https://vm.massedcompute.com).

Recursos

Licencia

MIT — consulta LICENSE.