Codeix — MCP-сервер для Claude Code: семантический поиск по коду
Строит индекс .codeindex и отдаёт агенту символы, вызовы и комментарии одним запросом. Пригодится, когда агент тратит токены на поиск нужной функции.
claude mcp add codeix -- npx -y codeixЧто делает Codeix
Codeix — MCP-сервер для семантического поиска по коду. Индекс собирается командой codeix build, а сам сервер запускается просто как codeix и следит за изменениями. Внутри Rust, tree-sitter и in-memory SQLite FTS5, так что сборка занимает секунды, а запросы идут миллисекундами.
Формат .codeindex — обычные JSONL-файлы: index.json, files.jsonl, symbols.jsonl, texts.jsonl. Их можно закоммитить в git, положить в npm/PyPI/crates.io пакет или просто прочитать через jq. MCP-сервер сам находит индексы зависимостей и монтирует их, поэтому запрос идёт и по вашему коду, и по библиотекам сразу.
Агенту доступны семь инструментов: explore, search, get_file_symbols, get_children, get_callers, get_callees и flush_index. search умеет ограничивать область только комментариями и строками через --scope text — удобно, когда надо найти TODO или текст ошибки, не цепляя код. Языки подключаются фичами tree-sitter при компиляции: Python, Rust, JavaScript, TypeScript, Go, Java, C, C++, Ruby, C#, Markdown — все включены по умолчанию. Для HTML, Vue, Svelte и Astro вырезаются встроенные <script>-блоки, а номера строк указывают на исходный файл. Если запускать codeix из корня, он обойдёт дерево вниз и посчитает проектом каждую папку с .git/ — так работают монорепы и соседние репозитории без конфига.
Какие задачи решает
- найти определение функции и её сигнатуру за один запрос вместо серии grep
- проследить, кто вызывает метод, и не пропустить вызовы в зависимостях
- искать только по комментариям и docstring, не задевая код
- отдать коллеге или CI готовый индекс вместе с репозиторием
- разобрать структуру монорепы с несколькими пакетами
Примеры запросов агенту
- Найди все места, где вызывается
Config.__init__, через codeix - Покажи символы в файле
src/main.pyи их диапазоны строк - Поищи по комментариям и строкам упоминание
TODOв проекте
Как установить Codeix
Командой платформы
claude mcp add codeix -- npx -y codeixКомандой платформы
codex mcp add codeix -- npx -y codeixФайл настроек
{
"mcpServers": {
"codeix": {
"command": "npx",
"args": [
"-y",
"codeix"
]
}
}
}Файл настроек
{
"servers": {
"codeix": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codeix"
]
}
}
}Командой платформы
gemini mcp add codeix npx -y codeixПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Codeix
Как установить Codeix в Claude Code?
Одной командой: claude mcp add codeix -- npx -y codeix. Отдельно ставить ничего не нужно, npx подтянет пакет.
Что делает Codeix?
Строит индекс .codeindex из исходников и отвечает на запросы агента о символах, файлах, вызовах и комментариях. Агент получает готовую карту кода вместо повторного чтения файлов.
Нужно ли что-то настраивать после запуска?
Нет. Сервер стартует сразу и находит проекты сам — каждый каталог с .git/ считается отдельным проектом со своим .codeindex.
