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¶
- Cria o monorepo
claude-mcp-arsenal/(npm workspaces). - Gera os 13 servidores MCP dentro de
packages/, cada um compackage.json,tsconfig.jsonesrc/index.tscompleto (catálogo de tools + dispatch via switch + handlers prontos para você implementar a lógica real). - Cria um
scripts/smoke-test.jsque sobe cada servidor, faz o handshake MCP e conta as tools viatools/list. - Roda
npm installenpm run build(compila os 13 servidores). - 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.jsque está em /caminho/. Depois rodenpm run smokedentro da pastaclaude-mcp-arsenale 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ê.