@regsorm/code-index-mcp

@regsorm/code-index-mcp

npm-обёртка для code-index — высокопроизводительного индексатора кода с MCP-протоколом для AI-моделей.

Rust + tree-sitter + SQLite. Индексация 57 тыс. файлов с нуля за 2 мин 41 с, запуск на готовом индексе — 2,3 с, ответ на запрос — около 10 мс.

Установка

npm install -g @regsorm/code-index-mcp

При установке postinstall скачивает готовый нативный бинарник под вашу платформу из GitHub Releases. Сам код на Rust — обёртка ничего не компилирует.

Поддерживаемые платформы: Windows x64, Linux x64, macOS arm64.

Запуск

Программа работает двумя процессами: фоновый индексатор строит индекс, MCP-сервер его читает. Без индексатора инструменты отвечают daemon_offline.

• Задайте переменную CODE_INDEX_HOME — папку для настроек и служебных файлов (например C:\tools\code-index).

• Создайте в ней daemon.toml со списком папок:

  [daemon]
  http_host = "127.0.0.1"
  http_port = 8015
  
  [[paths]]
  path = "C:/path/to/your/repo"
  alias = "main"
  

• Запустите индексатор:

  npx @regsorm/code-index-mcp daemon run
  

• Подключите MCP-сервер. Транспорт по умолчанию — stdio; для Claude Code / Cursor добавьте в MCP-конфигурацию:

  {
    "code-index": {
      "command": "npx",
      "args": ["-y", "@regsorm/code-index-mcp", "serve", "--path", "main=C:/path/to/your/repo"],
      "env": { "CODE_INDEX_HOME": "C:\\tools\\code-index" }
    }
  }
  

  Папка в --path должна быть перечислена в daemon.toml.

Документация

Полное описание инструментов (search_function, get_function, grep_body, find_symbol, get_callers и др.), режим демона и конфигурация — в основном репозитории.

Лицензия

MIT