RoadRaven — MCP-сервер для Claude Code: дерево роадмапа и статусы
Подключает агента к десктопному приложению RoadRaven: он читает открытый роадмап, правит узлы и ведёт статусы по ходу работы.
claude mcp add roadraven -- npx -y @roadraven/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 и сначала спрашивает.
Какие задачи решает
- разложить запрос на дерево целей, фаз и задач
- вести статус узлов, пока идёт работа
- передать фазу субагенту и проверить результат
- зафиксировать прогресс по задаче в заметках узла
- сверить правку с командами тестов и сборки проекта
Примеры запросов агенту
- Спланируй фичу экспорта в CSV как роадмап в RoadRaven и проведи её по фазам.
- Возьми первый узел со статусом «не начат» в открытом роадмапе, сделай работу и держи статус актуальным.
- Разбей релиз на фазы, напиши бриф по каждой и запусти их по очереди.
Как установить RoadRaven
Командой платформы
claude mcp add roadraven -- npx -y @roadraven/mcpКомандой платформы
codex mcp add claude-code -- npx -y @roadraven/mcpФайл настроек
{
"mcpServers": {
"claude-code": {
"command": "npx",
"args": [
"-y",
"@roadraven/mcp"
]
}
}
}Файл настроек
{
"servers": {
"claude-code": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@roadraven/mcp"
]
}
}
}Командой платформы
gemini mcp add claude-code npx -y @roadraven/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о RoadRaven
Как установить RoadRaven в Claude Code?
Через маркетплейс плагинов: сначала /plugin marketplace add Shuffzord/RoadRaven, затем /plugin install roadraven@roadraven. Нужен Node.js >= 24.
Что делает RoadRaven?
Связывает агента с десктопным приложением RoadRaven: агент читает открытый роадмап, создаёт и правит узлы, двигает их и меняет статусы. Два скилла плагина описывают, как через эти инструменты планировать и выполнять задачи.
Что нужно, чтобы инструменты работали?
Запущенное приложение RoadRaven и открытый в нём роадмап. Без приложения инструменты вернут app_not_running, без открытого файла — no_file_loaded.
