Provides an AI agent with high-speed code navigation, symbol searching, and call graph analysis using a pre-built SQLite index.
Also known as Regsorm/code-index-mcp, code-index-mcp, @regsorm/code-index-mcp
- Stars
- 165
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.17.1
- Last commit
- Nov 8, 2026
- License
- MIT
What is code-index MCP?
code-index provides an AI agent with high-speed code navigation, symbol searching, and call graph analysis using a pre-built SQLite index.
Summary generated from the project's README
About code-index MCP server
Developers working with large codebases or 1C:Enterprise 8.3 environments can provide AI agents with high-speed navigation and deep structural analysis. This server uses a pre-built SQLite index to deliver answers in milliseconds, preventing the need for an AI to manually crawl through thousands of files. It is designed to work with clients like Claude Code, Cursor, and VS Code through either a local stdio connection or a remote HTTP setup.
Users can choose between a core version with 25 tools or a specialized bsl-indexer build that includes 42 tools specifically for 1C metadata, forms, and event subscriptions. The system relies on a background daemon to maintain the index, which can be installed via PowerShell on Windows or through npm. By providing tools like search_function, get_call_tree, and get_object_structure, the server allows an agent to understand complex call graphs and data links without consuming excessive tokens.
What you can do with it
- 1Analyze complex call hierarchiesAsk the AI to find the shortest path of function calls between two specific points in the code.
- 2Explore 1C object metadataRequest a complete profile of a 1C object including its structure, forms, and modules.
- 3Perform semantic code searchesSearch for specific function bodies or class definitions using full-text search.
- 4Track changes via GitIdentify which files have changed between two specific snapshots or revisions.
Written from the project's README. Every use case is checked against a quote from it.
How to install code-index MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall code-index MCP in Claude Code
$ claude mcp add code-index-mcp -- npx -y @regsorm/code-index-mcpInstall code-index MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"code-index-mcp": {
"command": "npx",
"args": [
"-y",
"@regsorm/code-index-mcp"
]
}
}
}Install code-index MCP in VS Code
.vscode/mcp.json
{
"servers": {
"code-index-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@regsorm/code-index-mcp"
]
}
}
}Install code-index MCP in VS Code CLI
$ code --add-mcp '{"name":"code-index-mcp","type":"stdio","command":"npx","args":["-y","@regsorm/code-index-mcp"]}'Install code-index MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"code-index-mcp": {
"command": "npx",
"args": [
"-y",
"@regsorm/code-index-mcp"
]
}
}
}Install code-index MCP in Codex
$ codex mcp add code-index-mcp -- npx -y @regsorm/code-index-mcpInstall code-index MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.code-index-mcp] command = "npx" args = ["-y", "@regsorm/code-index-mcp"]
Install code-index MCP in Gemini CLI
$ gemini mcp add -s user code-index-mcp npx -- -y @regsorm/code-index-mcpInstall code-index MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"code-index-mcp": {
"command": "npx",
"args": [
"-y",
"@regsorm/code-index-mcp"
]
}
}
}Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubcode-index-mcp
Поиск по коду для ИИ-агентов. Один бинарник, индекс в SQLite, ответ за миллисекунды. Разбирает выгрузки 1С:Предприятие 8.3 — и из Конфигуратора, и из 1С:EDT.
Полное руководство · English · Документация · Журнал изменений
Выгрузки с именами файлов Unicode в NFC и NFD поддерживаются; для восстановления данных старого индекса нужна пересборка (версия данных 6).
Установка
Windows — одной командой
irm https://raw.githubusercontent.com/Regsorm/code-index-mcp/main/install.ps1 | iex
Скачивает последний выпуск в C:\tools\code-index, запоминает папку в
переменной окружения, создаёт заготовку файла настроек и печатает готовый блок
для .mcp.json.
С параметрами — папка установки, папка с исходниками, автозапуск при входе в систему:
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/Regsorm/code-index-mcp/main/install.ps1))) `
-InstallDir 'D:\code-index' -Repo 'main=D:\Repo1C' -RegisterAutostart
Автозапуск идёт через папку автозагрузки пользователя: прав администратора не
требует, окон не показывает. Остальные параметры — -Flavor core для сборки
без 1С, -Version 1.0.0 для конкретного выпуска, -Port и -DaemonPort, если
порты по умолчанию заняты. Полный список — Get-Help .\install.ps1 -Detailed.
Windows — вручную, готовый архив из выпуска
Скачивает последний выпуск, распаковывает в C:\tools\code-index и запоминает
эту папку в переменной окружения:
$dst = 'C:\tools\code-index'
New-Item -ItemType Directory -Force $dst | Out-Null
$url = (Invoke-RestMethod https://api.github.com/repos/Regsorm/code-index-mcp/releases/latest).assets |
Where-Object name -eq 'bsl-indexer-windows-x64.zip' |
Select-Object -ExpandProperty browser_download_url
Invoke-WebRequest $url -OutFile "$env:TEMP\code-index.zip"
Expand-Archive "$env:TEMP\code-index.zip" -DestinationPath $dst -Force
setx CODE_INDEX_HOME $dst
bsl-indexer — сборка с поддержкой 1С (42 инструмента). Нужна работа без 1С —
возьмите code-index-windows-x64.zip (25 инструментов). Для Linux и macOS в том
же выпуске лежат *-linux-x64.tar.gz и *-macos-arm64.tar.gz.
Дальше — файл настроек, запуск, подключение клиента и автозапуск. Всё это без скриптов, по шагам: установка вручную (English).
npm
npm install -g @regsorm/code-index-mcp
npx @regsorm/code-index-mcp serve --path /путь/к/репозиторию
Шаг postinstall скачивает готовый бинарник под вашу платформу — ничего не
компилируется. Пакет есть и в реестре MCP
под именем io.github.Regsorm/code-index. В обёртке только сборка без 1С.
Сервер serve только читает индекс, строит его фоновый индексатор. Поэтому
должны быть запущены npx @regsorm/code-index-mcp daemon run и задана
переменная CODE_INDEX_HOME — иначе инструменты отвечают daemon_offline.
Настройка — в полном руководстве.
Сборка из исходников
git clone https://github.com/Regsorm/code-index-mcp.git
cd code-index-mcp
cargo build --release -p code-index # без 1С
cargo build --release -p bsl-indexer --features enrichment # с поддержкой 1С
Нужен Rust 1.77+.
Сервер для команды
Готовые варианты развёртывания на Linux — в deploy/: Docker,
systemd и веб-панель администрирования баз,
чтобы добавлять и удалять базы из браузера.
Подключение к клиенту
Общий процесс по HTTP — один индекс на все сессии и все проекты. HTTP-сервер
встроен в программу, отдельный веб-сервер не нужен; по умолчанию он слушает
только 127.0.0.1:
{
"mcpServers": {
"code-index": {
"type": "http",
"url": "http://127.0.0.1:8011/mcp"
}
}
}
Слушает только 127.0.0.1 и принимает только loopback-значения заголовка Host.
Сервер в сети (--host 0.0.0.0 или [me].ip в serve.toml) перечисляет имена
клиентов в [me].allowed_hosts либо в CODE_INDEX_ALLOWED_HOSTS — иначе /mcp
отвечает 403 Host header is not allowed. Подробности —
полное руководство.
Отдельный процесс на сессию (stdio) — клиент сам запускает сервер при открытии
сессии, порт не нужен. Фоновый индексатор (daemon run) при этом тоже должен
работать: сервер только читает индекс, а строит его индексатор. Без него
инструменты отвечают daemon_offline:
{
"mcpServers": {
"code-index": {
"command": "npx",
"args": ["-y", "@regsorm/code-index-mcp", "serve", "--path", "."]
}
}
}
Работает с Claude Code, Cursor, VS Code, LibreChat — с любым клиентом MCP. Настройка фонового демона, список репозиториев, тонкие параметры — полное руководство.
Гард: чтение через индекс (необязательно)
Правило «по индексированным каталогам читай через code-index» модель под
нагрузкой забывает и уходит в обычное чтение файлов, которое в 3–10 раз
дороже по токенам. code-index-guard — хук PreToolUse для Claude Code и
Codex CLI: отклоняет обычное чтение, поиск и обход каталога только там, где
индекс отдаёт тот же файл, и подсказывает нужный инструмент. Новый, ещё не
проиндексированный или исключённый из индекса файл читается как обычно.
Сборка и установка — crates/code-index-guard.
Копия проекта с готовым индексом
code-index-copy делает копию проекта (файлы под контролем git или git worktree
на новой ветке) и переносит в неё базу индекса, так что индекс копии не строится
заново: демон копии при запуске только сверяет файлы с базой. Файлы исходника вне
git из базы копии убираются, конфиги демона и сервера выдачи копии пишутся сразу.
Подробности — crates/code-index-copy.
Зачем это нужно
Языковая модель без индекса ищет по коду тем же способом, что и человек без среды разработки: перебором. Один вопрос «кто вызывает эту процедуру» превращается в десяток последовательных обходов файлов, каждый из которых читает тысячи файлов и возвращает в контекст модели куски текста — вместе с оплатой этих кусков.
code-index делает работу заранее: разбирает исходники в синтаксическое дерево,
складывает символы, тела, вызовы и метаданные в SQLite и отдаёт агенту готовый
ответ по протоколу MCP. Модель получает три строки вместо трёх файлов.
Цифры
| Кодовая база | Файлов | Полная индексация | Запуск на готовом индексе |
|---|---|---|---|
| 1С:Управление Торговлей | 57 072 | 2 мин 41 с | 2,3 с |
| 1С:Бухгалтерия предприятия | 88 284 | 5 мин 51 с | 5,3 с |
| сайт на PHP | 157 772 | 13 мин 1 с | 8,0 с |
Полная индексация — разбор всего с нуля, делается один раз. У Бухгалтерии эти 5 мин 51 с складываются так: 2 мин 38 с ядро (синтаксические деревья и запись), 1 мин 58 с надстройка 1С (метаданные, формы, права, граф вызовов), 56 с сброс базы на диск. Дальше правки подхватываются по одной, за миллисекунды.
Запуск на готовом индексе сверяет время правки и размер каждого файла — ни одного чтения содержимого, ни одного хеша.
| Ответ на запрос | около 10 мс по HTTP, повторный из кэша — доли миллисекунды |
| Размер бинарника | 39 МБ без 1С, 41 МБ с 1С |
| Функций в индексе Управления Торговлей | 261 548 |
| Вызовов в графе там же | 1 962 941 |
Замеры сделаны на одной машине под Windows с обычным жёстким диском, август 2026.
Инструменты
Каждый вызов принимает алиас репозитория, так что один сервер обслуживает несколько кодовых баз сразу — в том числе с других машин.
Поиск и навигация
search_function search_class |
полнотекстовый поиск по функциям и классам |
get_function get_class |
точное имя → готовое тело; при промахе подсказывает похожие имена |
find_symbol |
символ любого рода: функция, класс, переменная, импорт |
get_imports |
импорты модуля или файла |
get_file_summary |
карта файла без чтения исходника |
Граф вызовов
get_callers get_callees |
кто вызывает процедуру и кого вызывает она |
find_path |
кратчайшая цепочка вызовов между двумя функциями |
get_call_tree |
дерево вызовов вниз или вверх на заданную глубину |
Содержимое файлов
read_file |
чтение с диапазоном строк; содержимое кода лежит в индексе, сжатое zstd |
list_files stat_file |
список файлов по маске и метаданные одного файла |
grep_body |
подстрока или регулярное выражение в телах функций и классов |
grep_code grep_text |
то же по всему тексту файлов кода и текстовых файлов |
search_text |
полнотекстовый поиск по текстовым форматам |
get_stats health |
состояние индекса и сервера |
Git (включается git = true у записи [[paths]]; git_path — если репозиторий лежит выше индекса)
git_log |
история коммитов ревизии или локальной даты с фильтром по пути |
git_changed_files |
изменённые файлы между двумя снимками: статусы, переименования, бинарные |
git_changes_by_object |
те же изменения, сгруппированные по объектам метаданных 1С |
git_diff |
unified diff одного файла с контекстом и пределом длины |
git_show_file |
историческое содержимое файла с диапазоном строк |
Даты — YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DDTHH:MM; зону можно задать параметром tz (+03:00 или UTC), иначе берётся локальная зона исполняющей машины (в контейнере ноды это UTC, timezone есть в каждом ответе). Пути — от корня индекса (для подкаталога изменения вне его не видны; для bare — от корня репозитория). Shallow-клон отвергается с подсказкой git fetch --unshallow, сеть инструменты не используют, а правка git/git_path применяется без перезапуска.
Для конфигураций 1С (сборка bsl-indexer, появляются сами при наличии
репозитория с выгрузкой)
get_object_structure |
реквизиты с типами и синонимами, табличные части, измерения и ресурсы, предопределённые элементы, свойства проведения |
get_object_profile |
паспорт объекта одним вызовом: структура, формы, модули, связи |
get_form_handlers |
обработчики событий управляемой формы, с привязкой к элементу |
get_event_subscriptions |
подписки на события: явные источники, наборы и определяемые типы, менеджеры, расширения; способ совпадения и предупреждения о неполноте |
get_data_links find_data_path |
граф связей данных: кто на кого ссылается и цепочка между двумя объектами |
find_references |
карта влияния: ссылки из метаданных, обращения в коде, права ролей |
get_register_writers |
регистраторы регистра и движения документа |
find_path_bsl |
цепочка вызовов процедур по графу выгрузки |
query_call_sites |
вызовы с контекстом места: в цикле, в Попытке, с глубиной вложенности |
get_node_structure |
скелет процедуры: циклы, Попытка и ветки с номерами строк |
get_line_context |
что находится на строке: процедура, содержащие её блоки, признаки |
search_terms |
смысловой поиск процедур по именам, синонимам и комментариям |
get_role_rights |
права ролей на объект и права одной роли |
bsl_sql |
произвольный запрос на чтение к таблицам метаданных и графов |
Что даёт поддержка 1С
- Разбираются обе формы выгрузки: XML из Конфигуратора и
.mdoиз 1С:EDT. - Граф связей данных строится по ссылочным типам реквизитов, измерений и табличных частей: для Бухгалтерии предприятия это 65 421 ребро.
- Из модулей извлекаются директивы компиляции (
&НаСервере,&НаКлиенте) и аннотации расширений (&Вместо,&После,&Перед) вместе с именем переопределяемой процедуры. - Понимаются оба синтаксиса BSL — русский и английский.
- Регистр имени объекта не важен: кириллические имена приводятся к записи из конфигурации, в ответе имя показывается канонически.
Подробности — docs/bsl-indexer.md.
Языки
Полный разбор синтаксиса: Python, JavaScript, TypeScript, Java, Rust, Go, PHP, C,
C++, C#, Ruby, Swift, 1С (BSL), HTML. Метаданные 1С — XML Конфигуратора и .mdo
из EDT. Плюс полнотекстовая индексация 50+ текстовых форматов (.md, .json,
.yaml, .toml, .sql и других).
Дальше
- Полное руководство на русском — демон, конфигурация, CLI, архитектура
- docs/operations.md — эксплуатация: перезапуск, добавление репозиториев, диагностика
- docs/bsl-indexer.md — сборка для 1С
- CHANGELOG.md — журнал изменений
Участие
Ошибки и предложения — в issues, вопросы и обсуждения — в Discussions. Как прислать правку — CONTRIBUTING.md, об уязвимостях — SECURITY.md.
Лицензия
MIT, см. LICENSE.
Проект стоит на tree-sitter, грамматике BSL от сообщества 1c-syntax, rusqlite, rayon и Rust SDK для MCP.
code-index MCP questions
How do I add code-index MCP to Claude Code?
Run claude mcp add code-index-mcp -- npx -y @regsorm/code-index-mcp in your terminal. Add --scope user to make it available in every project.
How do I add code-index MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does it improve AI performance?
It reduces token usage and increases speed by providing specific code symbols and metadata instead of requiring the model to read entire files through brute-force searching.
Can I use it with Claude Code or Cursor?
Yes, it works with any MCP client including Claude Code, Cursor, VS Code, and LibreChat.
Does it require a running daemon?
Yes, the server reads the index, but a background indexer (daemon) must be running to build it; otherwise, tools return a daemon_offline error.