mcp-cloud-remote

Servidor MCP em Node.js para infraestrutura em nuvem: Locaweb (VPS / Cloud Server Pro, com SSH em remote_exec) e AWS (CLI v2, SSO, inventário EC2 e SSM Run Command). Os dois provedores sobem desligados e são habilitados de forma independente (LOCAWEB_ENABLED, AWS_ENABLED). Pacote e binário: mcp-cloud-remote; chave MCP: cloud-remote.

Por que só o npm i não listava o servidor antes? Instalar o pacote apenas baixa arquivos em node_modules; Cursor, Claude Desktop e Claude Code só enxergam um MCP que esteja nos seus arquivos de configuração. Agora o postinstall grava a entrada cloud-remote nesses arquivos. Se o servidor continuar ausente: (1) reinicie o cliente; (2) confira se MCP_CLOUD_REMOTE_SKIP_CLIENT_REGISTER não está definida (opt-out); (3) veja no stderr do npm i se algum JSON estava inválido ou sem permissão e use o registro manual.

Instalação

Requer Node.js ^20.11.0, ^22.0.0 ou ^24.0.0.

npm i mcp-cloud-remote

O postinstall registra o servidor em Cursor (~/.cursor/mcp.json), Claude Desktop (claude_desktop_config.json no caminho do seu SO) e Claude Code / CLI (mcpServers de ~/.claude.json, ou de $CLAUDE_CONFIG_DIR/.claude.json quando a variável está definida no ambiente do npm i). No Windows com Claude Desktop MSIX, grava em %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude. O npm oculta a saída do postinstall de dependências: use npm i mcp-cloud-remote --foreground-scripts para ver os arquivos gravados.

• cria o arquivo se não existir e preserva os outros servidores e chaves;
• se cloud-remote já existir, não sobrescreve e avisa que a entrada foi mantida;
• grava node + o dist/main.js deste pacote (caminho absoluto), sem env: nenhum token ou senha é gravado;
• JSON inválido ou falta de permissão não apagam nada: o aviso vai ao stderr com o caminho do arquivo e o npm i termina com sucesso;
• MCP_CLOUD_REMOTE_SKIP_CLIENT_REGISTER=1 (ou true) pula o registro.

Depois, reinicie o Cursor, o Claude Desktop e as sessões claude abertas. O servidor aparece como cloud-remote, com Locaweb e AWS ainda desligados.

Credenciais

As credenciais não vão para o registro automático. Habilite cada provedor quando precisar:

• Locaweb: use a tool locaweb_setup_connection (valida e grava no .env local) ou defina LOCAWEB_ENABLED=true, LOCAWEB_USER_LOGIN=seu-usuario-locaweb e LOCAWEB_API_TOKEN=coloque-seu-token-aqui no env do servidor MCP. Para SSH, locaweb_setup_ssh.
• AWS: use aws_setup_sso (AWS CLI v2 + SSO); nenhum token vai para o .env.

Os valores acima são placeholders; nunca cole credenciais reais em repositórios, issues ou configs versionadas. Modelo completo de variáveis: .env.example.

Registro manual

Se o registro automático não rodou ou falhou, acrescente a entrada em mcpServers do arquivo do seu cliente (troque o caminho pelo da pasta onde o pacote foi instalado, por exemplo node_modules/mcp-cloud-remote):

{
  "mcpServers": {
    "cloud-remote": {
      "command": "node",
      "args": ["C:/caminho/para/node_modules/mcp-cloud-remote/dist/main.js"]
    }
  }
}

Arquivos: Cursor ~/.cursor/mcp.json; Claude Desktop %APPDATA%\Claude\claude_desktop_config.json (Windows), ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou ~/.config/Claude/claude_desktop_config.json (Linux); Claude Code ~/.claude.json (ou $CLAUDE_CONFIG_DIR/.claude.json, ou claude mcp add --scope user; o CLI não lê mcp.json dentro da pasta de config). Claude Desktop MSIX (Windows): %LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json. Reinicie o cliente depois.

Documentação

• docs/configuration.md: variáveis de ambiente, clientes stdio em detalhe (Cursor, Claude Desktop, Claude Code), HTTP/SSE, assistentes de setup, operações destrutivas, SSH / remote_exec e troubleshooting.
• docs/aws.md: AWS (SSO, multi-conta, inventário EC2, SSM Run Command, troubleshooting).
• docs/tool-catalog.md e docs/tool-catalog.json: catálogo de tools.
• docs/development.md: scanner de secrets e distribuição npm; procedimento de publicação em docs/npm-publish.md.
• docs/rebrand-plan.md: nome do pacote e decisões de rebrand.

Licença

MIT. Ver LICENSE.