graphlens-mcp constrói um grafo de código com um comando e reduz o uso de tokens em 10–23x

graphlens-mcp é um novo servidor MCP baseado no motor graphlens que constrói um grafo de código estrutural com um comando e o disponibiliza imediatamente a um agente de IA sem integração manual.

O que o motor graphlens pode fazer graphlens pega código-fonte em

Python, TypeScript, Go, Rust e PHP e o normaliza em um grafo tipado unificado. Os nós representam símbolos: funções, classes, variáveis, métodos. As arestas descrevem relacionamentos: `CALLS` (chamada de função), `HAS_TYPE` (tipo), `INHERITS_FROM` (herança).

Cada nó recebe um ID SHA-256 determinístico, o que torna o resultado reproduzível entre execuções e adequado para pipelines de agentes cacheáveis. A diferença chave em relação ao grep é entender semântica. Grep pesquisa texto linha por linha: não sabe se a string encontrada é um nome de função, argumento ou comentário.

O grafo opera em símbolos e suas relações. Se um backend Python chama um cliente TypeScript, a aresta `CALLS` atravessará a fronteira da linguagem e persistirá no grafo. Para monorepositorios e projetos fullstack, isso é crítico: dependências entre camadas se tornam objetos explícitos, não strings de texto que precisam ser rastreadas manualmente.

O que as medições em código real mostraram O autor executou 936 testes

em apache/superset—um projeto de código aberto com aproximadamente 400 mil linhas de código em Python e TypeScript. O limite do teste foram os pontos de entrada da API `/api/v1/...`.

O objetivo de cada teste era responder perguntas como "o que mudará se eu modificar essa função?" 936 execuções fornecem conclusões estatisticamente significativas. Resultados: Análise de impacto: grafo é mais barato que grep em custo de tokens por 10–23 vezes Consultas pontuais ("encontrar definição", "mostrar chamadas de método"): diferença é mínima Cadeias entre linguagens (Python → TypeScript): grep não encontra nada—grafo constrói o caminho completo Estabilidade: IDs SHA-256 fornecem resultados reproduzíveis em re-execuções do agente Onde você precisa entender o que quebra quando você muda uma função ou classe—o grafo vence muitas vezes.

Onde é suficiente encontrar uma string por padrão—a diferença é negligenciável. A economia de tokens é particularmente perceptível em grandes bases de código com alta conectividade entre módulos.

Do motor ao produto final

Artigos anteriores descreveram o próprio motor graphlens—a mecânica interna da construção do grafo. Mas um motor não é um produto. Para conectá-lo a um agente de IA, você tinha que instalar independentemente dependências, configurar a API e escrever código de integração para um protocolo específico. Para a maioria dos desenvolvedores, essa era uma barreira séria.

"Um motor não é um produto.

Para realmente conectar graphlens a um agente, pip install e uma API não são suficientes. Você precisa escrever bastante código de integração", admite o autor. graphlens-mcp fecha essa lacuna.

Sob o capô está o mesmo motor, mas acima dele há um servidor MCP pronto que aceita solicitações do agente em formato padronizado imediatamente após a instalação. MCP (Model Context Protocol) se tornou o padrão de facto para integrar ferramentas externas com modelos de linguagem—é suportado por Claude, GPT e a maioria dos frameworks de IA modernos. graphlens-mcp é compatível com qualquer agente que suporte esse protocolo, sem configuração adicional.

A instalação é um comando. Segundo o autor, da instalação até o primeiro resultado real em seu próprio projeto leva cinco minutos. O produto está em estágio alfa, licença MIT, distribuído gratuitamente.

O que isso significa

Grafo de código estrutural como ferramenta para agentes de IA não é teoria, mas prática mensurável com números concretos em código real. graphlens-mcp baixa a barreira de entrada para equipes que constroem agentes para revisão de código, refatoração ou análise de dependência: em vez de montar integração por conta própria, eles obtêm uma ferramenta pronta com eficiência documentada. Código aberto e licença gratuita permitem experimentar sem nenhuma obrigação comercial.