Octocode
Octocode — MCP-сервер сообщества (автор — muvon). Индексатор кода с семантическим поиском и графами знаний. Ставится из исходников. Лицензия Apache-2.0.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- muvon
- Лицензия
- Apache-2.0
- Транспорт
- stdio
- Авторизация
- none
- ОС
- linux, macos, windows
- Языки
- rust
Уровень риска: medium
Только чтение кода и локальный индекс; код из ответов инструментов попадает в модель клиента; удалённые провайдеры — по желанию.
Настройка клиентов
{
"code": "codex mcp add octocode -- octocode mcp --path /path/to/your/project\ncodex mcp list",
"lang": "bash",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
Octocode — CLI на Rust и MCP-сервер для изучения кодовых баз. Он объединяет семантический поиск, структурный поиск и живой граф символов и зависимостей. Подключается к Claude Code, Codex, Cursor, Windsurf и другим MCP-клиентам.
Возможности по README:
- поиск кода по смыслу: гибридный векторный и ключевой поиск с настраиваемым переранжированием;
- определения и использования: структурный поиск по текущему исходному коду;
- связи между файлами и символами: импорты, вызовы, наследование, реализации;
- сигнатуры без загрузки целых файлов. С языковым сервером добавляются переходы к определениям, ссылки и подсказки;
- локальная работа: по умолчанию эмбеддинги и переранжирование выполняют локальные модели FastEmbed, API-ключ не нужен.
MCP-инструменты:
semantic_search— поиск кода, документации и истории по смыслу. Нужен индекс;structural_search— определения, использования и шаблоны AST в текущем коде;view_signatures— сигнатуры функций, объявления и импорты;graphrag— связи файлов и символов и пути зависимостей;lsp_*— определения, ссылки, подсказки, символы и автодополнение. Нужен языковой сервер и флаг--with-lsp.
Поддерживаются Rust, Python, TypeScript и JavaScript, Go, PHP, C и C++, Ruby, Elixir, Java, Swift, Svelte, Lua, CSS, JSON, Bash и Markdown. С сервером OctoFS ассистент может править файлы по ID строк, которые возвращает structural_search.
Кому подойдёт
- Разработчикам больших репозиториев, где агенту дорого читать файлы целиком.
- Тем, кто осваивает чужой код: поиск по смыслу и граф зависимостей.
- Командам, которым важна приватность: модели по умолчанию локальные.
Другие серверы — в категории разработка.
Установка
Linux и macOS (или Unix-совместимая оболочка в Windows):
curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/master/install.sh | shНа macOS можно поставить через brew install muvon/tap/octocode, есть также бинарники в релизах и cargo install octocode. Затем проиндексируйте проект:
cd /path/to/your/project
octocode index
octocode search "authentication middleware"Структурный поиск, сигнатуры и граф работают и без индекса. Для папки без Git используйте octocode index --no-git.
Подключение к клиентам
Конфиги приведены дословно из README. Замените /path/to/your/project на абсолютный путь к проекту. Подробнее — в инструкции как подключить MCP.
claude mcp add --transport stdio octocode -- octocode mcp --path /path/to/your/project
claude mcp listJSON-конфиг подходит для Claude Desktop, Cursor и Windsurf. После сохранения перезапустите клиент. Команда octocode должна быть в PATH.
Проверка
Выполните octocode --version. В клиенте попросите ассистента найти, где определена функция, или показать сигнатуры файла. По умолчанию MCP-сервер не обновляет индекс: после изменений перезапускайте octocode index или держите запущенным octocode watch.
Примеры задач
Найди, где в проекте реализована проверка JWT, и покажи цепочку вызовов до неё.Какие модули зависят от database/pool.rs?Риски
Octocode только читает код и строит индекс — файлы проекта он не меняет. Что учитывать:
- инструменты возвращают исходный код, и модель вашего ИИ-клиента его получает, даже если сам Octocode работает на локальных моделях;
- если включить удалённых провайдеров эмбеддингов, переранжирования или LLM, они получат запросы и нужные фрагменты кода. Ключи передавайте через переменные окружения;
- индексы хранятся вне репозитория. Индексация учитывает
.gitignoreи.noindex— исключите секреты и файлы, которые не должны попасть в индекс; - установщик выполняется через
curl | sh— при желании сначала просмотрите скрипт.
Частые вопросы
Нужен ли API-ключ?
Нет, по умолчанию используются локальные модели FastEmbed. Их файлы скачиваются при первом запуске.
Работает ли сервер без индекса?
Частично: структурный поиск, сигнатуры, граф и LSP работают без индекса, семантический поиск — только с ним.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.