# RoadRaven

Подключает агента к десктопному приложению RoadRaven: он читает открытый роадмап, правит узлы и ведёт статусы по ходу работы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: Shuffzord
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Shuffzord/RoadRaven/tree/HEAD/plugins/claude-code
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/roadraven

## Что делает

RoadRaven — локальное десктопное приложение, которое показывает план проекта деревом и обновляет его по мере выполнения. MCP-сервер даёт агенту 21 инструмент: прочитать открытый роадмап, создать узел, изменить его, переместить, удалить и выставить статус. Плагин для Claude добавляет два скилла, которые объясняют, как этими инструментами планировать и выполнять работу.

Приложение должно быть запущено. Все инструменты ходят к нему по локальному соединению на `127.0.0.1`. Если приложение закрыто, вернётся `app_not_running`; если не открыт роадмап — `no_file_loaded`. Приложение открывает и сохраняет файлы только там, где вы уже работаете, поэтому запрос на другой путь вернёт `path_not_permitted`. Сервер читает один файл — `event-api.json` в папке пользовательских данных RoadRaven (`~/.config/RoadRaven` на Linux, `%LOCALAPPDATA%\RoadRaven` на Windows), куда приложение пишет свой локальный порт. Никуда больше данные не уходят, телеметрии нет.

Скиллы идут только с установкой плагина для Claude. Мастер первичной настройки и путь через `npx` дают инструменты без них. Скиллы находят команды тестов, линтера и сборки в README проекта, манифесте пакета или конфиге CI, поэтому язык не важен. Файлы сервер пишет только тогда, когда вы сами запускаете `npx @roadraven/mcp init`: он предлагает добавить короткий раздел RoadRaven в `CLAUDE.md` и сначала спрашивает.

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

## Установка

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

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

### Codex

**Командой платформы**
```bash
codex mcp add claude-code -- npx -y @roadraven/mcp
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add claude-code npx -y @roadraven/mcp
```

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

## Примеры запросов агенту
- Спланируй фичу экспорта в CSV как роадмап в RoadRaven и проведи её по фазам.
- Возьми первый узел со статусом «не начат» в открытом роадмапе, сделай работу и держи статус актуальным.
- Разбей релиз на фазы, напиши бриф по каждой и запусти их по очереди.

## Похожие
- [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