SymDex: El Indexador de Código MCP de Código Abierto Reduce el Uso de Tokens en Agentes de IA

Qué hace SymDex

SymDex aborda un problema específico con los agentes de IA de programación actuales: cuando se les pide encontrar una función, normalmente leen todo el archivo que contiene esa función, consumiendo tokens de la ventana de contexto antes de realizar cualquier trabajo real. El desarrollador creó SymDex porque cada agente de IA que usaba leía archivos completos solo para encontrar una función.

Las matemáticas de los tokens

Según el material fuente, un archivo de 300 líneas contiene aproximadamente 10,500 caracteres. Con los tokenizadores BPE (utilizados por los principales LLM) que procesan aproximadamente 3-4 caracteres por token, eso son alrededor de 3,000 tokens para el código, más el espacio en blanco de la indentación y el encuadre de la respuesta, totalizando aproximadamente 3,400 tokens para buscar una función. Una sesión de depuración real podría tocar 8-10 archivos, consumiendo la mayor parte de la ventana de contexto antes de realizar cualquier corrección.

Cómo funciona

SymDex pre-indexa tu base de código una vez. Después de la indexación, tu agente sabe exactamente dónde está cada función y clase sin leer archivos completos. El mismo archivo de 300 líneas que cuesta ~3,400 tokens para leer devuelve resultados en ~100 tokens con SymDex.

Características adicionales incluyen:

• Búsqueda semántica local (encontrar funciones por lo que hacen, no solo por nombre)
• Seguimiento del gráfico de llamadas para que tu agente sepa qué se rompe antes de tocar nada

Comenzar

Instalación y uso básico:

pip install symdex
symdex index ./your-project --name myproject
symdex search "validate email"

Compatibilidad y licencia

SymDex funciona con Claude, Codex, Gemini CLI, Cursor, Windsurf y cualquier agente compatible con MCP. También tiene una CLI independiente. La herramienta es gratuita, tiene licencia MIT y se ejecuta completamente en tu máquina. Es compatible con 12 lenguajes de programación.