RoadRaven
io.github.Shuffzord/roadraven · 10 stars · TypeScript
MCP server Create and update roadmap tree nodes and statuses in the RoadRaven desktop app (must be running).
Install
The repo has no one-line install. Follow its README.
Published as
- npm
@roadraven/mcpstdio
From the server's entry in the official MCP Registry.
Files
@roadraven/mcp — RoadRaven for Claude Code
The MCP server and Claude Code plugin for RoadRaven, a local desktop app that shows your project's plan as a tree and updates it live as the work happens. The server gives an agent 21 tools to read the open roadmap, create, edit, move and delete nodes, and set their status. The plugin adds two skills that tell Claude how to use those tools to plan and run real work.
Source-available, FSL-1.1-MIT.
The app must be running
Every tool talks to the RoadRaven desktop app over a local connection on
127.0.0.1. With the app closed, tools return app_not_running; with no
roadmap open, no_file_loaded. The app only opens or saves files where you
already work, so a request for another path returns path_not_permitted.
Install the app first: see Install.
What it does on your machine
- Downloads and runs
@roadraven/mcpfrom npm throughnpx, pinned to the plugin's exact version, as a local stdio MCP server. - Reads one file:
event-api.jsonin RoadRaven's user-data folder (~/.config/RoadRavenon Linux,%LOCALAPPDATA%\RoadRavenon Windows), which the desktop app writes with its local port. - Connects only to the RoadRaven desktop app, over a WebSocket on
127.0.0.1, to read and edit the open roadmap. It sends nothing anywhere else and collects no telemetry. - Writes files only when you run
npx @roadraven/mcp inityourself: it offers to add a short RoadRaven section to aCLAUDE.md, and asks first. - The skills are instructions for Claude; they run nothing on their own.
Install
Three ways, easiest first.
Setup Wizard. Launch RoadRaven. The first-run Setup Wizard detects Claude Code and OpenCode and registers this server with one click. Re-open it from the ⚙ button in the top bar. If the Claude Code plugin below is already installed, the wizard defers to it.
Claude Code plugin. Requires Node.js >= 24. From inside Claude Code:
/plugin marketplace add Shuffzord/RoadRaven
/plugin install roadraven@roadraven
Any other MCP host. Requires Node.js >= 24. Pin the version that matches your installed app (the app warns on a major.minor mismatch):
claude mcp add -s user roadraven -- npx -y @roadraven/mcp@0.9.2
To add a short RoadRaven section to a CLAUDE.md (it asks whether to use
the current project or ~/.claude/CLAUDE.md), run
npx -y @roadraven/mcp@0.9.2 init.
Skills
The skills ship with the Claude Code plugin install only. The Setup Wizard
and npx paths give you the tools without them.
roadraven:orchestrate turns a request into a roadmap tree (goal,
phases, tasks), writes a brief per phase, hands each phase to a sub-agent,
re-runs your project's own checks to verify the result, and keeps node
status current while you watch.
Plan the CSV export feature as a roadmap in RoadRaven and run it phase by phase.
roadraven:work-node is how one task gets done: claim a node, set it in
progress, checkpoint into its notes, touch only the files the brief names,
prove a fix with a failing test first, run the checks, report, set the final
status.
Pick up the first not-started node in the open roadmap, do the work, and keep its status current.
Both skills find your project's test, lint and build commands from its README, package manifest or CI config, so they work in any language. If the app is not running they ask you once to start it, then fall back to a markdown worklog and say so.
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 10
- Language
- TypeScript
- Last push
- 2026-10-26
- MCP Registry
- io.github.Shuffzord/roadraven
- Homepage
- shuffzord.github.io/RoadRaven
- Topics
- ai-agents, bun, claude-code, desktop-app, electrobun, local-first, mcp, mcp-server, project-planning, react, roadmap, typescript, claude-code-mod, claude-code-plugin
Same repo on other shelves
Next on this shelf
- 6421io.github.beSaif/zenpilotio.github.beSaif/zenpilotLet Claude use your Zen Browser, like Claude in Chrome. No extension, only sites you allow.10
- 6422Mobio.github.benkaiser/mobAn AI-first personal CRM you run in natural language: contacts, reminders, notes, and more.10
- 6423Mob (Demo)io.github.benkaiser/mob-demoEphemeral no-signup demo of Mob, an AI-first personal CRM you run in natural language.10
- 6424McuBuddyio.github.cunjun/mcubuddyAI-native MCU debugging and observability through probes, symbols, RTOS, logs, and build tools.10
- 6425io.github.cyanheads/gdelt-mcp-serverio.github.cyanheads/gdelt-mcp-serverSearch and analyze global news coverage and US TV transcripts via the GDELT Project APIs.10
- 6426io.github.keshrath/agent-commio.github.keshrath/agent-commAgent intercommunication - messaging, channels, shared state, and real-time events10