Massed Compute MCP

Navegue pelo inventário de GPUs, inicie e gerencie VMs e audite a cobrança no Massed Compute a partir de qualquer agente de IA.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Servidor MCP Massed Compute

Um servidor Model Context Protocol que permite que assistentes de IA — Claude, Cursor, Codex, ChatGPT e outros clientes compatíveis com MCP — interajam com sua conta Massed Compute: navegue pelo inventário de GPUs, inicie e gerencie VMs, audite cobranças e descubra receitas de configuração.

Conteúdo

Visão geral

Os pacotes publicados a partir deste repositório são um proxy literal do endpoint MCP público em https://vm.massedcompute.com/api/mcp — zero superfície adicional. Cada mensagem JSON-RPC (initialize, tools/list, tools/call, resources/list, resources/read, ping, …) é encaminhada sem alterações com sua chave de API armazenada injetada como cabeçalho Bearer, e as respostas retornam sem alterações. Nada é adicionado, renomeado, filtrado ou reescrito no caminho:

  • O endpoint hospedado é dono do catálogo. Ferramentas, recursos, esquemas e descrições vêm do endpoint ativo — o pacote local nunca fica desatualizado quando novos recursos (como receitas de configuração) são lançados upstream.
  • O endpoint hospedado é dono da segurança. A aplicação do escopo da chave (chaves somente leitura ocultam ferramentas destrutivas) e a redação de credenciais acontecem no lado do servidor, de forma idêntica para todos os clientes.
  • O que o pacote local adiciona é exatamente o que um cliente stdio precisa: uma ponte stdio↔HTTP transmissível, armazenamento convencional do sistema operacional para sua chave de API (0600 em POSIX) e configuração de cliente de uso único via init.

Emita uma chave somente leitura para assistentes de análise e o endpoint rejeitará chamadas de ferramentas destrutivas (iniciar, reiniciar, encerrar, alterações de chave SSH) no momento da chamada. Funciona com Claude Code, Claude Desktop, Cursor e Codex. Execute massed-compute-mcp tools para imprimir o catálogo ativo — inventário de GPUs, imagens de VM, ciclo de vida de instâncias, cupons, cobrança, chaves SSH e receitas de configuração.

Além das ferramentas brutas, a Massed Compute publica Agent Skills — modelos de fluxo de trabalho em markdown para operações comuns, como seleção de GPU e auditoria de custos. Documentação completa em vm-docs.massedcompute.com/docs/category/mcp.

Instalação

Etapa 1. Obtenha sua chave de API

Abra vm.massedcompute.com/settings/api, crie uma chave (somente leitura para assistentes de análise; acesso total para permitir iniciar / reiniciar / encerrar / alterações de chave SSH), copie-a.

Etapa 2. Escolha um caminho de instalação

  • Endpoint hospedado — aponte seu cliente para a URL HTTP transmissível, instalação zero
  • CLI local — executa na sua máquina, chave armazenada no diretório de configuração do seu SO

Endpoint hospedado

Os pacotes locais fazem proxy deste endpoint literalmente, então apontar seu cliente diretamente para ele oferece o catálogo idêntico sem nada para instalar. Escolha o trecho para o seu 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

O Claude Desktop ainda não suporta MCP HTTP transmissível, então use mcp-remote como uma ponte stdio↔HTTP. Configuração em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %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

Instale via qualquer ecossistema de sua preferência:

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

Execute a configuração de uso único:

massed-compute-mcp init

init solicita a chave, valida-a upstream, armazena-a em 0600 (POSIX), detecta clientes MCP instalados (Claude Code, Cursor, Claude Desktop, Codex) e oferece configurar cada um. Um backup com carimbo de data/hora é feito antes de qualquer edição no cliente. Reinicie os clientes configurados para ativar as ferramentas.

Localização do arquivo de configuração:

  • Linux: $XDG_CONFIG_HOME/massed-compute/config.json (com fallback para ~/.config/...)
  • macOS: ~/Library/Application Support/massed-compute/config.json
  • Windows: %APPDATA%\massed-compute\config.json

Não interativo (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

Adicione ou remova um cliente posteriormente:

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

install-client é idempotente — executar novamente quando a entrada já corresponde é um no-op silencioso.

Verificando a conexão

massed-compute-mcp doctor

doctor confirma que a chave armazenada ainda funciona, imprime o catálogo de ferramentas e mostra trechos copiáveis para qualquer cliente que você não configurou automaticamente. Ou apenas pergunte ao seu assistente "Valide minha chave de API Massed Compute." — uma resposta { message: "Valid Token" } confirma a configuração.

Referência da CLI

ComandoO que faz
massed-compute-mcp (sem argumentos)Executa o servidor MCP via stdio
massed-compute-mcp initConfiguração de primeira execução: solicitar, validar, armazenar, configurar clientes
massed-compute-mcp doctorVerifica a chave armazenada e imprime trechos para clientes
massed-compute-mcp install-client <id>Configura um único cliente (claude-code, cursor, claude-desktop, codex)
massed-compute-mcp uninstall-client <id>Remove nossa entrada da configuração de um cliente
massed-compute-mcp config showImprime o caminho de configuração resolvido, chave mascarada, cadeia de resolução
massed-compute-mcp logoutExclui a chave de API armazenada
massed-compute-mcp tools [--json]Busca e imprime o catálogo de ferramentas ativo do endpoint hospedado
massed-compute-mcp versionImprime a versão

Resolução de chave

Quando o servidor inicia, a chave de API é obtida da primeira fonte que fornecer uma:

  1. Flag CLI --token <value>
  2. Flag CLI --token-file <path> (primeira linha, sem espaços)
  3. Variável de ambiente MASSED_COMPUTE_API_KEY
  4. Arquivo de configuração armazenado escrito por init

Se nenhuma dessas opções estiver definida, o servidor sai com código diferente de zero e um ponteiro para massed-compute-mcp init. Substitua o upstream com MASSED_COMPUTE_API_BASE_URL (padrão https://vm.massedcompute.com).

Recursos

Licença

MIT — veja LICENSE.