Octocode

MCP-сервер и CLI для исследования кода: поиск и разбор по вашему проекту и по всему GitHub с экономией токенов

MCP-серверОфициальный

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

Почему такой уровень

  • Читает локальные файлы и ходит в GitHub по сети
  • Может использовать токен GitHub
Все причины и проверки

bgauryy/octocode

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/octocode

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio octocode -- npx @octocodeai/mcp@latest

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": [
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": [
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"octocode","type":"stdio","command":"npx","args":["@octocodeai/mcp@latest"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "octocode": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Выполните в терминале

codex mcp add octocode -- npx @octocodeai/mcp@latest

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.octocode]
command = "npx"
args = ["@octocodeai/mcp@latest"]

Если файл уже есть, допишите блок в конец.

Выполните в терминале

gemini mcp add -s user octocode npx @octocodeai/mcp@latest

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": [
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": [
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": [
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": [
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "octocode": {
      "type": "local",
      "command": [
        "npx",
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "octocode": {
      "command": "npx",
      "args": [
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": [
        "@octocodeai/mcp@latest"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит c265e3f.

Текст для агента

Добавь MCP-сервер: npx @octocodeai/mcp@latest. Для приватных репозиториев пользователь входит через npx octocode auth login.

Другие способы из описания автора
npx octocode

Запуск исследования кода прямо из терминала.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Octocode дает агенту единый набор инструментов для исследования кода: поиск через ripgrep и разбор по AST, дерево файлов, точное чтение фрагментов и работа через LSP. Он работает и с локальным кодом, и с внешними источниками: репозиториями GitHub, пулл-реквестами и пакетами npm. Под капотом движок на Rust, поэтому результаты быстрые и компактные по токенам даже на больших репозиториях. Пользоваться можно как CLI в терминале или как MCP-сервером внутри агента, набор инструментов и движок в обоих случаях одинаковые. Аутентификация в GitHub необязательна, но открывает приватные репозитории и более высокие лимиты API.

Для кого. Для разработчиков, которым нужно, чтобы агент разбирался в чужом и своем коде до того, как что-то менять.

Подходит, если

  • Нужно найти, как что-то устроено в большом репозитории
  • Нужно исследовать чужой проект или пакет на GitHub
  • Хочется экономить токены на разборе кода

Не подходит, если

  • Нужен полноценный редактор с правкой кода, а не исследование
  • Проект небольшой и хватает встроенного поиска агента

Пример запроса к агенту

Через octocode найди, где в этом репозитории обрабатывается авторизация, и покажи ключевые файлы

Ограничения

Без токена GitHub работают только публичные репозитории и действуют базовые лимиты API. Для приватного кода и высоких лимитов нужна авторизация. Основной сценарий это чтение и исследование кода, а не его правка.

Как отключить. Удалите сервер octocode из конфигурации MCP или удалите пакет CLI.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
GITHUB_TOKEN
секрет
Токен GitHub для доступа к приватным репозиториям и повышенных лимитов API, необязателен

Проверка безопасности

  • Читает локальные файлы и ходит в GitHub по сети
  • Может использовать токен GitHub

Коротко о README

README описывает Octocode как инструмент исследования кода для агентов и разработчиков, работающий по локальному коду и по GitHub одним набором инструментов. Внутри движок на Rust, поиск через ripgrep и AST, работа с деревьями, точным чтением и LSP. Доступ как CLI и как MCP-сервер, есть однокликовая установка для популярных клиентов. Авторизация в GitHub необязательна и расширяет возможности. Лицензия MIT.

Частые вопросы

Нужен ли токен GitHub?

Нет для публичного кода. Для приватных репозиториев и высоких лимитов войдите через npx octocode auth login.

Это CLI или MCP?

И то и другое: одинаковый набор инструментов и движок доступны и как CLI в терминале, и как MCP-сервер.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.Звезды репозитория
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.Звезды репозитория
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.Звезды репозитория

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.Звезды репозитория
Foxx AIOctocode

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.