Servidor MCP para Projetos TypeScript Substitui o Padrão Grep do Claude Code por Consultas Indexadas de Símbolos

Um desenvolvedor criou um servidor MCP especificamente projetado para melhorar o desempenho do Claude Code em projetos TypeScript, substituindo seu padrão de grep-e-adivinhação por buscas indexadas de símbolos. A ferramenta é gratuita e de código aberto.

O Problema com o Comportamento Atual do Agente

Ao usar Claude Code e Cursor em projetos TypeScript, surge um padrão comum: o agente pesquisa entre arquivos, abre correspondências prováveis, lê quantidades significativas de código, percebe que está no lugar errado e tenta novamente. O agente carece de consciência estrutural da base de código e inicia cada sessão do zero.

Como o Servidor MCP Funciona

O servidor fornece acesso estruturado à base de código mantendo um índice SQLite em tempo real do projeto que inclui:

• Símbolos
• Locais de chamada
• Importações
• Hierarquia de classes

Isso permite que o agente consulte a estrutura diretamente. Em vez de procurar por "handleRequest", o agente pode ir diretamente ao arquivo e linha exatos para aquele símbolo.

Benchmarks de Desempenho

Testado em um projeto TypeScript com 31 arquivos, realizando as mesmas tarefas com e sem o índice:

• Encontrar uma função: 1.350 tokens com grep vs. 500 tokens com índice (63% a menos)
• Rastrear chamadores em 3 arquivos: 2.850 tokens com grep vs. 900 tokens com índice (68% a menos)
• Mapear herança em 15+ arquivos: 4.800 tokens com grep vs. 1.000 tokens com índice (79% a menos)

O desempenho do grep se degrada conforme a base de código cresce, enquanto as consultas indexadas permanecem consistentes.

De Onde Vêm as Economias

O desenvolvedor inicialmente pensou que a busca por símbolos seria o principal benefício, mas descobriu três áreas-chave onde o índice proporciona ganhos significativos de eficiência:

• Consultas get_callers substituem o padrão em que agentes leem 4-5 arquivos tentando descobrir quem chama uma função
• Leituras parciais: saber a linha exata significa ler 20 linhas em vez de um arquivo inteiro (representando mais da metade das economias)
• trace_middleware informa ao agente o que é executado antes de um manipulador de rota, eliminando a necessidade de ler o roteador, cada arquivo de middleware e reconstruir a ordem

Limitações

A ferramenta tem dificuldades com:

• Padrões dinâmicos (nomes de métodos computados, etc.)
• Configurações de injeção de dependência
• Qualquer coisa fora da sua própria base de código

Embora não seja perfeita, a ferramenta reduz significativamente o ciclo de tentativa e erro no desenvolvimento assistido por agentes.