Pular para conteúdo

Bootstrap do Claude MCP Arsenal — Como usar

Este é um script único e autônomo. Você não precisa que ninguém monte o projeto pra você: basta colocar este arquivo no seu servidor (ou pedir ao Claude Code, que tem acesso ao seu servidor, para executá-lo) e ele constrói TODO o Arsenal sozinho.

O que o script faz, em ordem

  1. Cria o monorepo claude-mcp-arsenal/ (npm workspaces).
  2. Gera os 13 servidores MCP dentro de packages/, cada um com package.json, tsconfig.json e src/index.ts completo (catálogo de tools + dispatch via switch + handlers prontos para você implementar a lógica real).
  3. Cria um scripts/smoke-test.js que sobe cada servidor, faz o handshake MCP e conta as tools via tools/list.
  4. Roda npm install e npm run build (compila os 13 servidores).
  5. Registra automaticamente os 13 servidores no seu ~/.claude/settings.json.

Resultado validado: 13/13 servidores, 66 tools.

Como rodar

Coloque o arquivo bootstrap-arsenal.js no servidor e execute:

# instalação completa (cria + instala + builda + registra no Claude)
node bootstrap-arsenal.js

# escolher uma pasta de destino
node bootstrap-arsenal.js /opt/claude-mcp-arsenal

# só gerar os arquivos, sem instalar/buildar
node bootstrap-arsenal.js --no-build

# gerar, instalar e buildar, mas SEM mexer no settings.json
node bootstrap-arsenal.js --no-register

Pedindo ao Claude Code (no seu servidor)

"Execute o arquivo bootstrap-arsenal.js que está em /caminho/. Depois rode npm run smoke dentro da pasta claude-mcp-arsenal e me mostre o resultado."

Validar depois de instalar

cd claude-mcp-arsenal
npm run smoke
# RESULTADO esperado: 13/13 servers, 66 tools totais

Em seguida, reinicie o Claude Code para que ele carregue os servidores registrados.

Os 13 servidores gerados

ID Servidor Camada Tools
MCP-01 Context Intelligence Foundation 5
MCP-02 Git Intelligence Foundation 5
MCP-05 Env Inspector Foundation 5
MCP-03 Database Inspector Data 5
MCP-04 Docs Fetcher Data 6
MCP-13 SQLite Memory Data 5
MCP-07 Code Quality Quality 5
MCP-08 Dependency Scanner Quality 5
MCP-09 Test Intelligence Quality 5
MCP-06 API Health Operations 5
MCP-10 Log Analyzer Operations 5
MCP-11 Performance Profiler Operations 5
MCP-12 Infrastructure Tools Operations 5
Total 13 servidores 4 camadas 66 tools

Onde colocar sua lógica real

Cada packages/mcp-XX-*/src/index.ts traz funções handle_<nome_da_tool>(args) com um stub funcional. Substitua o corpo dessas funções pela lógica real (ex.: no MCP-02, use o simple-git; no MCP-03, use o pg; etc.). Depois rode npm run build novamente.

Observação: o script gera o esqueleto executável e a infraestrutura completa (protocolo MCP, build, registro). A lógica de negócio de cada tool é o ponto de extensão deixado pronto para você.