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

Только чтение кода и локальный индекс; код из ответов инструментов попадает в модель клиента; удалённые провайдеры — по желанию.

Настройка клиентов

codex
{
    "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 list

JSON-конфиг подходит для 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 для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники