Arquitetura Claude MCP Arsenal¶

Este documento detalha a arquitetura completa, os agentes (servidores) e as ferramentas do Claude MCP Arsenal, com base na análise profunda da landing page oficial.

Visão Geral¶

O Claude MCP Arsenal é um ecossistema projetado para conectar o Claude Code diretamente a projetos de software reais. Ele elimina a necessidade de copiar e colar logs, schemas ou diffs no chat, fornecendo ao Claude acesso direto a Git, bancos de dados, logs, APIs, dependências, testes e infraestrutura.

A solução consiste em: - 13 Servidores MCP (Model Context Protocol) - 66 Ferramentas (Tools) no código-fonte - 13 Domínios de atuação técnica - 4 Camadas Arquiteturais integradas

A comunicação entre o motor de IA (Claude Code) e os servidores ocorre via protocolo MCP stdio / JSON-RPC, atuando como camada de comando e controle.

Arquitetura em 4 Camadas¶

A arquitetura não é um conjunto de scripts isolados, mas sim uma estrutura integrada de 4 camadas, conectando o agente principal ao projeto com dados reais.

1. Descoberta & Contexto (Foundation Layer)¶

Focada em mapear o projeto rapidamente, fornecendo contexto persistente, inteligência de versionamento e variáveis de ambiente. - Total de Ferramentas: 15 tools

2. Dados & Documentação (Data Layer)¶

Fornece dados estruturados, documentação de bibliotecas e preservação de estado/memória entre as sessões. - Total de Ferramentas: 13 tools

3. Qualidade & Segurança (Quality Layer)¶

Auditoria de código em tempo real, cobrindo smells, dependências, vulnerabilidades e inteligência de testes. - Total de Ferramentas: 15 tools

4. Operações & Infraestrutura (Operations Layer)¶

Monitoramento do sistema, health checks, análise de logs e profiling de performance, tudo sem sair do chat. - Total de Ferramentas: 18 tools

Mapeamento Completo dos Agentes (13 Servidores MCP)¶

Abaixo estão detalhados os 13 servidores MCP que compõem o arsenal, organizados por suas respectivas camadas.

Camada 1: Foundation Layer¶

ID	Nome do Servidor	Tools	Descrição e Funcionalidades
MCP-01	Context Intelligence	5	Contexto persistente com SQLite local. Busca de símbolos, observações e dependentes. Evita poluir o chat com informações redundantes.
MCP-02	Git Intelligence	5	Integração via `simple-git`. Acesso a histórico Git, diff, blame e regressão.
MCP-05	Env Inspector	5	Validação e comparação de variáveis de ambiente, com detecção de secrets.

Camada 2: Data Layer¶

ID	Nome do Servidor	Tools	Descrição e Funcionalidades
MCP-03	Database Inspector	5	Conexão PostgreSQL read-only. Fornece schema, `EXPLAIN ANALYZE` e verificação de índices.
MCP-04	Docs Fetcher	4	Cache SQLite com TTL para 22 bibliotecas (React, Next.js, Prisma, Zod, Tailwind, etc.). Fornece documentação atualizada sob demanda.
MCP-13	SQLite Memory	4	Memória persistente. Contexto e decisões preservados entre sessões via SQLite local. O Claude retoma o estado anterior sem precisar de reexplicações (continuidade real).

Camada 3: Quality Layer¶

ID	Nome do Servidor	Tools	Descrição e Funcionalidades
MCP-07	Code Quality	5	Análise de code smells, complexidade ciclomática e código duplicado.
MCP-08	Dependency Scanner	5	Scanner de vulnerabilidades npm/pip, análise de licenças e identificação de dependências obsoletas.
MCP-09	Test Intelligence	5	Análise de cobertura de testes, identificação de flaky tests e padrões de execução.

Camada 4: Operations Layer¶

ID	Nome do Servidor	Tools	Descrição e Funcionalidades
MCP-06	API Health	5	Testes de endpoints HTTP, schemas, breaking changes e load test com bloqueio SSRF embutido.
MCP-10	Log Analyzer	5	Busca em logs, correlação entre eventos e identificação de anomalias operacionais.
MCP-11	Performance Profiler	4	Benchmarks, V8 profiles e flamegraphs.
MCP-12	Infrastructure Tools	4	Diagnóstico de Docker, disco, portas e processos diretamente pelo Claude Code.

Tecnologias e Códigos Identificados¶

Embora a landing page seja focada na arquitetura e na oferta comercial, os seguintes detalhes técnicos e de código podem ser extraídos do conteúdo:

Stack Base dos Servidores:
Runtime: Node.js (Validado especificamente na versão 20.20.2).
Protocolo de Comunicação: MCP (Model Context Protocol) operando via stdio / JSON-RPC.
Estrutura do Projeto: Arquitetura npm workspaces (cross-platform, funciona em macOS, Linux e Windows).
Bibliotecas e Integrações Internas:
simple-git: Utilizada no MCP-02 para operações de repositório.
SQLite: Utilizada extensivamente para cache (Docs Fetcher MCP-04) e memória persistente (Context MCP-01 e Memory MCP-13).
PostgreSQL: Suporte nativo read-only no MCP-03.
Ecossistema npm/pip: Suportado no MCP-08 para scan de dependências.
Detalhes de Implementação (Tools):
As 66 tools são expostas via dispatch no código-fonte utilizando o CallToolRequestSchema.
A página menciona explicitamente que o roteamento de ferramentas é feito através de um switch case dentro de cada src/index.ts de cada servidor.
Script de Setup Guiado (setup.js):
O pacote inclui um script chamado setup.js.
Ele exibe um catálogo interativo no terminal.
Executa automaticamente npm install + npm run build.
Registra os servidores selecionados no arquivo de configuração do Claude: .claude/settings.json.

Fluxo de Valor¶

A promessa técnica da arquitetura é reduzir os tokens consumidos (de ~18k em prompts manuais para ~2.4k utilizando MCP) e eliminar o drift (perda de contexto) entre sessões, permitindo diagnósticos baseados em evidências reais do código, banco de dados e infraestrutura.

Análise gerada a partir da raspagem da página oficial de vendas do Claude MCP Arsenal.