Serveur MCP pour les projets TypeScript remplace les motifs Grep de Claude Code par des recherches de symboles indexés

Un développeur a créé un serveur MCP spécifiquement conçu pour améliorer les performances de Claude Code sur les projets TypeScript en remplaçant son modèle de recherche approximative par des recherches indexées de symboles. L'outil est gratuit et open source.

Le problème avec le comportement actuel de l'agent

Lors de l'utilisation de Claude Code et Cursor sur des projets TypeScript, un schéma courant apparaît : l'agent recherche dans les fichiers, ouvre les correspondances probables, lit des quantités importantes de code, réalise que ce n'est pas le bon endroit et réessaie. L'agent manque de conscience structurelle de la base de code et recommence chaque session à zéro.

Comment fonctionne le serveur MCP

Le serveur fournit un accès structuré à la base de code en maintenant un index SQLite en direct du projet qui inclut :

• Symboles
• Sites d'appel
• Importations
• Hiérarchie des classes

Cela permet à l'agent d'interroger directement la structure. Au lieu de rechercher "handleRequest", l'agent peut aller directement au fichier et à la ligne exacts pour ce symbole.

Benchmarks de performance

Testé sur un projet TypeScript de 31 fichiers avec les mêmes tâches effectuées avec et sans l'index :

• Trouver une fonction : 1 350 tokens avec grep contre 500 avec l'index (63 % de moins)
• Retracer les appelants sur 3 fichiers : 2 850 tokens avec grep contre 900 avec l'index (68 % de moins)
• Cartographier l'héritage sur 15+ fichiers : 4 800 tokens avec grep contre 1 000 avec l'index (79 % de moins)

Les performances de grep se dégradent à mesure que la base de code grandit, tandis que les requêtes indexées restent constantes.

D'où viennent les économies

Le développeur pensait initialement que la recherche de symboles serait le principal avantage, mais a découvert trois domaines clés où l'index apporte des gains d'efficacité significatifs :

• Les requêtes get_callers remplacent le schéma où les agents lisent 4-5 fichiers pour essayer de comprendre qui appelle une fonction
• Lectures partielles : connaître la ligne exacte signifie lire 20 lignes au lieu d'un fichier entier (représentant plus de la moitié des économies)
• trace_middleware indique à l'agent ce qui s'exécute avant un gestionnaire de route, éliminant le besoin de lire le routeur, chaque fichier middleware et de reconstruire l'ordre

Limitations

L'outil a du mal avec :

• Les motifs dynamiques (noms de méthodes calculés, etc.)
• Les configurations d'injection de dépendances
• Tout ce qui est en dehors de votre propre base de code

Bien que non parfait, l'outil réduit significativement la boucle d'essais et d'erreurs dans le développement assisté par agent.