Servidor MCP para Proyectos TypeScript Reemplaza Patrones Grep de Claude Code con Búsquedas de Símbolos Indexados

Un desarrollador ha creado un servidor MCP específicamente diseñado para mejorar el rendimiento de Claude Code en proyectos TypeScript al reemplazar su patrón de búsqueda y adivinanza con consultas indexadas de símbolos. La herramienta es gratuita y de código abierto.

El problema con el comportamiento actual del agente

Al usar Claude Code y Cursor en proyectos TypeScript, surge un patrón común: el agente busca entre archivos, abre coincidencias probables, lee cantidades significativas de código, se da cuenta de que es el lugar equivocado y vuelve a intentarlo. El agente carece de conciencia estructural de la base de código y comienza cada sesión desde cero.

Cómo funciona el servidor MCP

El servidor proporciona acceso estructurado a la base de código manteniendo un índice SQLite en vivo del proyecto que incluye:

• Símbolos
• Sitios de llamada
• Importaciones
• Jerarquía de clases

Esto permite al agente consultar la estructura directamente. En lugar de buscar "handleRequest", el agente puede ir directamente al archivo y línea exactos para ese símbolo.

Puntos de referencia de rendimiento

Probado en un proyecto TypeScript de 31 archivos con las mismas tareas realizadas con y sin el índice:

• Encontrar una función: 1,350 tokens con búsqueda vs. 500 tokens con índice (63% menos)
• Rastrear llamadores en 3 archivos: 2,850 tokens con búsqueda vs. 900 tokens con índice (68% menos)
• Mapear herencia en 15+ archivos: 4,800 tokens con búsqueda vs. 1,000 tokens con índice (79% menos)

El rendimiento de la búsqueda se degrada a medida que crece la base de código, mientras que las consultas indexadas se mantienen consistentes.

De dónde provienen los ahorros

El desarrollador inicialmente pensó que la búsqueda de símbolos sería el beneficio principal, pero descubrió tres áreas clave donde el índice proporciona ganancias significativas de eficiencia:

• get_callers las consultas reemplazan el patrón donde los agentes leen 4-5 archivos tratando de averiguar quién llama a una función
• Lecturas parciales: conocer la línea exacta significa leer 20 líneas en lugar de un archivo completo (representando más de la mitad de los ahorros)
• trace_middleware le dice al agente qué se ejecuta antes de un manejador de ruta, eliminando la necesidad de leer el enrutador, cada archivo de middleware y reconstruir el orden

Limitaciones

La herramienta tiene dificultades con:

• Patrones dinámicos (nombres de métodos calculados, etc.)
• Configuraciones de inyección de dependencias
• Cualquier cosa fuera de tu propia base de código

Aunque no es perfecta, la herramienta reduce significativamente el ciclo de prueba y error en el desarrollo asistido por agentes.