Сервер MCP для проектов на TypeScript заменяет поиск по шаблону Grep в Claude Code на индексированный поиск символов

Разработчик создал MCP-сервер, специально предназначенный для повышения производительности Claude Code в TypeScript-проектах, заменяя его паттерн grep-and-guess на индексированный поиск символов. Инструмент бесплатный и с открытым исходным кодом.

Проблема с текущим поведением агента

При использовании Claude Code и Cursor в TypeScript-проектах возникает распространённая проблема: агент ищет по файлам, открывает вероятные совпадения, читает значительные объёмы кода, понимает, что это не то место, и пытается снова. Агенту не хватает структурного понимания кодовой базы, и он начинает каждую сессию с нуля.

Как работает MCP-сервер

Сервер предоставляет структурированный доступ к кодовой базе, поддерживая живой SQLite-индекс проекта, который включает:

• Символы
• Места вызова
• Импорты
• Иерархию классов

Это позволяет агенту напрямую запрашивать структуру. Вместо поиска "handleRequest" агент может перейти непосредственно к точному файлу и строке для этого символа.

Тесты производительности

Протестировано на TypeScript-проекте из 31 файла с одинаковыми задачами, выполненными с индексом и без:

• Найти одну функцию: 1350 токенов с grep против 500 токенов с индексом (на 63% меньше)
• Отследить вызывающие объекты в 3 файлах: 2850 токенов с grep против 900 токенов с индексом (на 68% меньше)
• Отобразить наследование в 15+ файлах: 4800 токенов с grep против 1000 токенов с индексом (на 79% меньше)

Производительность grep ухудшается с ростом кодовой базы, тогда как индексированные запросы остаются стабильными.

Источник экономии

Разработчик изначально думал, что основная польза будет от поиска символов, но обнаружил три ключевые области, где индекс обеспечивает значительный прирост эффективности:

• Запросы get_callers заменяют паттерн, при котором агенты читают 4–5 файлов, пытаясь понять, кто вызывает функцию
• Частичное чтение: знание точной строки означает чтение 20 строк вместо целого файла (что составляет более половины экономии)
• trace_middleware сообщает агенту, что выполняется перед обработчиком маршрута, устраняя необходимость читать роутер, каждый файл промежуточного ПО и восстанавливать порядок

Ограничения

Инструмент плохо справляется с:

• Динамическими паттернами (вычисляемые имена методов и т.д.)
• Настройками внедрения зависимостей
• Всем, что находится за пределами вашей собственной кодовой базы

Хотя инструмент не идеален, он значительно сокращает цикл проб и ошибок в разработке с помощью агентов.