Code-Graph-MCP: Servidor MCP de Código Aberto Reduz o Uso de Tokens de Código do Claude em 40-60%

code-graph-mcp é um servidor MCP de código aberto que indexa bases de código em um grafo de conhecimento AST para reduzir o uso de tokens do Claude Code. Em vez do Claude fazer múltiplas chamadas grep/read/glob para entender a estrutura do código, ele consulta o grafo para obter respostas estruturadas em chamadas únicas.

Como Funciona

A ferramenta analisa código com Tree-sitter, extrai símbolos (funções, classes, tipos, interfaces) e seus relacionamentos (chamadas, imports, herança, exports, vinculações de rotas HTTP), então armazena tudo em SQLite com busca de texto completo FTS5 e sqlite-vec para similaridade vetorial. Suporta 10 linguagens: TypeScript, JavaScript, Go, Python, Rust, Java, C, C++, HTML e CSS.

Ferramentas Principais

• project_map — Visão geral completa da arquitetura em uma chamada (módulos, dependências, funções importantes, pontos de entrada)
• semantic_code_search — Busca híbrida combinando BM25 + similaridade vetorial com fusão RRF
• get_call_graph — Rastreia chamadores/receptores com CTEs recursivos
• impact_analysis — Veja tudo que depende de uma função antes de alterá-la
• trace_http_chain — Rastreia rotas HTTP do manipulador à chamada do banco de dados (suporta Express, Flask/FastAPI, Go)
• module_overview, dependency_graph, find_similar_code, get_ast_node — Funções adicionais do kit de ferramentas

Resultados de Eficiência

Em um projeto Rust com 33 arquivos:

• Compreensão da arquitetura do projeto: Reduzido de 5-8 chamadas de ferramentas para 1 chamada
• Rastreamento de cadeia de chamadas de 2 níveis: Reduzido de 8-15 chamadas para 1 chamada
• Análise de impacto pré-alteração: Reduzido de 10-20+ chamadas para 1 chamada
• Encontrar função por conceito: Reduzido de 3-5 chamadas para 1 chamada

No geral: ~80% menos chamadas de ferramentas por tarefa de navegação, ~95% menos código-fonte despejado no contexto e economia de 40-60% no total de tokens por sessão.

Detalhes Técnicos

A indexação incremental usa árvore Merkle BLAKE3 para rastrear hashes de conteúdo — apenas arquivos alterados são reanalisados. Subárvores de diretórios inalterados são completamente ignoradas via cache mtime. Quando uma assinatura de função muda, a propagação de alterações regenera automaticamente o contexto para todos os chamadores subsequentes.

A ferramenta não tem dependências externas — é um único binário de 19MB com SQLite embutido e sqlite-vec incluído. Não requer Docker, API de nuvem ou servidor de banco de dados. As incorporações locais opcionais usam um modelo de incorporação baseado em Candle, com controle de recursos para que você possa compilar sem ele se a busca vetorial não for necessária.

Instalação

Funciona com Claude Code, Cursor, Windsurf ou qualquer cliente MCP.

Plugin Claude Code (recomendado):

/plugin marketplace add sdsrss/code-graph-mcp
/plugin install code-graph-mcp

Isso inclui o servidor MCP mais comandos de barra (/understand, /trace, /impact), ganchos de indexação automática (reindexa a cada edição de arquivo), exibição de saúde StatusLine e atualizações automáticas.

Para qualquer cliente MCP:

npx -y @sdsrs/code-graph

Ou adicione à sua configuração MCP:

{
  "mcpServers": {
    "code-graph": {
      "command": "npx",
      "args": ["-y", "@sdsrs/code-graph"]
    }
  }
}

Quando Não Usar

grep ainda é melhor para busca exata de strings/constantes. Se você precisa encontrar todas as ocorrências de TODO ou um código de erro específico, use grep. code-graph-mcp brilha quando você precisa entender estrutura, relacionamentos e arquitetura de código.