Octocode
MCP-сервер и CLI для исследования кода: поиск и разбор по вашему проекту и по всему GitHub с экономией токенов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает локальные файлы и ходит в GitHub по сети
- Может использовать токен GitHub
Установка
В терминале, через 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/mcp.json, для всех проектов
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": [
"@octocodeai/mcp@latest"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
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.
Добавь 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, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything