graphlens-mcp gera um grafo de código com um único comando e reduz o gasto de tokens de 10 a 23 vezes

O graphlens-mcp é um novo servidor MCP construído sobre o motor graphlens. Ele gera um grafo estrutural do código com um único comando e o disponibiliza imediatamente a um agente de IA, sem código de integração manual.

O que o motor faz

O motor graphlens pega código-fonte em Python, TypeScript, Go, Rust e PHP e o normaliza em um único grafo tipado. Os nós são símbolos: funções, classes, variáveis, métodos. As arestas descrevem relações: `CALLS` (chamada), `HAS_TYPE` (tipo), `INHERITS_FROM` (herança). Cada nó recebe um ID SHA-256 determinístico, então o resultado é reproduzível entre execuções e adequado para pipelines de agentes com cache.

A diferença fundamental em relação ao grep é que o grafo entende semântica. O grep busca texto linha a linha: não sabe se a linha encontrada é o nome de uma função, um argumento ou um comentário. O grafo opera com símbolos e suas relações. Se um backend em Python chama um cliente em TypeScript, a aresta `CALLS` atravessa a fronteira entre linguagens e fica preservada no grafo. Em monorrepositórios e projetos fullstack isso é crítico: as dependências entre camadas viram objetos explícitos, e não trechos de texto que é preciso rastrear à mão.

O que a medição em código real mostrou

O autor executou 936 testes no apache/superset, um projeto open source com cerca de 400 mil linhas de código em Python e TypeScript. O limite do teste foram os pontos de entrada `/api/v1/...`. Cada teste precisava responder perguntas como "o que muda se eu mexer nesta função?". 936 execuções bastam para conclusões estatisticamente significativas.

Resultados:

• Análise de impacto (impact analysis): o grafo é de 10 a 23 vezes mais barato que o grep em custo de tokens
• Consultas pontuais ("encontre a definição", "mostre as chamadas de um método"): a diferença é mínima
• Cadeias entre linguagens (Python → TypeScript): o grep simplesmente não as encontra; o grafo constrói o caminho completo
• Estabilidade: os IDs SHA-256 dão resultados reproduzíveis em execuções repetidas do agente

Quando é preciso entender o que vai quebrar ao alterar uma função ou classe, o grafo leva vantagem de longe. Quando basta achar uma string por padrão, a diferença é desprezível. A economia de tokens é mais perceptível em bases de código grandes, com alta conectividade entre módulos.

Do motor ao produto pronto

Os artigos anteriores descreviam o motor graphlens em si, a mecânica interna da construção do grafo. Mas um motor não é um produto. Para conectá-lo a um agente de IA, era preciso instalar as dependências, configurar a API e escrever uma camada para um protocolo de interação específico. Para a maioria dos desenvolvedores, é uma barreira séria.

"Um motor não é um produto.

Para realmente conectar o graphlens a um agente, pip install e API não bastam. É preciso escrever um monte de código de integração", admite o autor.

O graphlens-mcp preenche essa lacuna. Por baixo está o mesmo motor, mas por cima há um servidor MCP pronto, que aceita requisições do agente em formato padronizado logo após a instalação.

O MCP (Model Context Protocol) virou o padrão de fato para integrar ferramentas externas a modelos de linguagem; é suportado por Claude, GPT e pela maioria dos frameworks de IA modernos. O graphlens-mcp é compatível com qualquer agente que suporte esse protocolo, sem configuração adicional.

A instalação exige um único comando. Segundo o autor, do comando até o primeiro resultado real em um projeto próprio levam cinco minutos. O produto está em fase alpha, com licença MIT, e é distribuído gratuitamente.

O que isso significa

Um grafo estrutural de código como ferramenta para agentes de IA não é teoria, mas uma prática mensurável, com números concretos em código real. O graphlens-mcp reduz a barreira de entrada para equipes que constroem agentes de code review, refatoração ou análise de dependências: em vez de montar a integração por conta própria, elas ganham uma ferramenta pronta com eficácia documentada. O código aberto e a licença gratuita permitem testar sem qualquer compromisso comercial.