SymDex: Indexador de Código MCP de Código Aberto Reduz o Uso de Tokens por Agentes de IA

O que o SymDex Faz

O SymDex aborda um problema específico com os atuais agentes de IA de programação: quando solicitados a encontrar uma função, eles normalmente leem o arquivo inteiro que contém essa função, consumindo tokens da janela de contexto antes de realizar qualquer trabalho real. O desenvolvedor criou o SymDex porque todo agente de IA que usava estava lendo arquivos inteiros apenas para encontrar uma função.

A Matemática dos Tokens

De acordo com o material fonte, um arquivo de 300 linhas contém aproximadamente 10.500 caracteres. Com tokenizadores BPE (usados pelos principais LLMs) processando cerca de 3-4 caracteres por token, isso representa cerca de 3.000 tokens para o código, mais espaços em branco de indentação e estruturação da resposta, totalizando aproximadamente 3.400 tokens para procurar uma função. Uma sessão real de depuração pode envolver 8-10 arquivos, consumindo a maior parte da janela de contexto antes que qualquer correção seja feita.

Como Funciona

O SymDex pré-indexa sua base de código uma vez. Após a indexação, seu agente sabe exatamente onde cada função e classe está sem ler arquivos completos. O mesmo arquivo de 300 linhas que custa ~3.400 tokens para ler retorna resultados em ~100 tokens com o SymDex.

Recursos adicionais incluem:

• Busca semântica local (encontre funções pelo que fazem, não apenas pelo nome)
• Rastreamento de grafo de chamadas para que seu agente saiba o que quebra antes de tocar em qualquer coisa

Começando

Instalação e uso básico:

pip install symdex
symdex index ./seu-projeto --name meuprojeto
symdex search "validar email"

Compatibilidade e Licenciamento

O SymDex funciona com Claude, Codex, Gemini CLI, Cursor, Windsurf e qualquer agente compatível com MCP. Também possui uma CLI independente. A ferramenta é gratuita, licenciada pelo MIT e roda inteiramente em sua máquina. Suporta 12 linguagens de programação.