Об этом проекте

codebase-memory-mcp — движок кодовой аналитики, разработанный для обслуживания AI-программистских агентов через Model Context Protocol (MCP). Он разбирает кодовую базу в персистентный граф знаний, состоящий из функций, классов, цепочек вызовов, HTTP-маршрутов и кросс-сервисных связей, затем отвечает на структурные запросы к этому графу. Ключевые характеристики, указанные в README: - Индексация: AST-анализ tree-sitter с 162 встроенными грамматиками, скомпилированными в бинарник. Пайплайн RAM-first использует сжатие LZ4, SQLite в памяти и алгоритм Ахо-Корасик для поиска паттернов. По данным README, индексация ядра Linux (28 млн строк, 75 тыс. файлов) занимает около 3 минут. - Гибридный LSP: лёгкая C-реализация алгоритмов разрешения типов для Python, TypeScript/JavaScript/JSX/TSX, PHP, C#, Go, C, C++, Java, Kotlin, Rust и Perl, покрывающая привязку параметров, вывод типов возвращаемых значений, подстановку generics и языко-специфичные паттерны разрешения. - Поверхность запросов: 15 MCP-инструментов, включая обзор архитектуры, трассировку call-graph, анализ воздействий, обнаружение мёртвого кода, Cypher-подобные графовые запросы, семантический поиск, BM25 full-text поиск и поиск по коду. README сообщает о субмиллисекундных структурных запросах и сокращении токенов по сравнению с посимвольным исследованием файлов. - Графовая модель: типы рёбер CALLS, IMPORTS, DEFINES, IMPLEMENTS, INHERITS, HTTP_CALLS, EMITS, LISTENS_ON, DATA_FLOWS, SIMILAR_TO и SEMANTICALLY_RELATED. Кросс-репозиторные рёбра CROSS_* связывают узлы между репозиториями в одном хранилище. - Infrastructure-as-code: Dockerfiles, манифесты Kubernetes и Kustomize-оверлеи индексируются как графовые узлы с кросс-ссылками. - Распределение: один нативный исполняемый файл для macOS, Linux и Windows, без языкового рантайма, хостингового сервиса или API-ключа. Также доступен через npm, PyPI, Homebrew, Scoop, Winget, Chocolatey, AUR и go install. Вся обработка выполняется локально. - Работа: команда установки автоматически обнаруживает и настраивает поддерживаемые coding agents. Общий координационный демон управляет фоновыми watch-процессами, задачами индексации и опциональным UI. Параметры auto-index и auto-watch настраиваются. Встроенный 3D-графический UI визуализации доступен на localhost:9749. - Командная работа: опциональный zstd-сжатый снимок SQLite (.codebase-memory/graph.db.zst) можно закоммитить, чтобы коллеги могли выполнить начальную загрузку из артефакта и запустить инкрементную индексацию вместо полной повторной индексации. Проект не включает LLM; MCP-клиент выступает интеллектуальным слоем, который переводит вопросы на естественном языке в графовые запросы. В README упоминается препринт (arXiv:2603.27277), описывающий дизайн и бенчмарки, а также документированы практики безопасности, включая локальную обработку и проверку релизных артефактов.