# Codeix

Строит индекс .codeindex и отдаёт агенту символы, вызовы и комментарии одним запросом. Пригодится, когда агент тратит токены на поиск нужной функции.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: montanetech
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/montanetech/codeix
- Обновлён: 2026-02-21
- HTML: https://affpapa.org/nevibecode/mcp/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/` — так работают монорепы и соседние репозитории без конфига.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add codeix -- npx -y codeix
```

### Codex

**Командой платформы**
```bash
codex mcp add codeix -- npx -y codeix
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "codeix": {
            "command": "npx",
            "args": [
                "-y",
                "codeix"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "codeix": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "codeix"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add codeix npx -y codeix
```

## Когда брать
- найти определение функции и её сигнатуру за один запрос вместо серии grep
- проследить, кто вызывает метод, и не пропустить вызовы в зависимостях
- искать только по комментариям и docstring, не задевая код
- отдать коллеге или CI готовый индекс вместе с репозиторием
- разобрать структуру монорепы с несколькими пакетами

## Примеры запросов агенту
- Найди все места, где вызывается `Config.__init__`, через codeix
- Покажи символы в файле `src/main.py` и их диапазоны строк
- Поищи по комментариям и строкам упоминание `TODO` в проекте

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md