ClaudeCodeMod

All shelves / MCP servers

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.

Open the repo

Files

plugins/claude-code/README.md

@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/mcp from npm through npx, pinned to the plugin's exact version, as a local stdio MCP server.
  • Reads one file: event-api.json in RoadRaven's user-data folder (~/.config/RoadRaven on Linux, %LOCALAPPDATA%\RoadRaven on 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 init yourself: it offers to add a short RoadRaven section to a CLAUDE.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.

More: MCP install guide, plugin authoring guide.

Facts

Kind
MCP server
Repo
Shuffzord/RoadRaven
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

Mods

Next on this shelf

  1. 6421io.github.beSaif/zenpilotio.github.beSaif/zenpilotLet Claude use your Zen Browser, like Claude in Chrome. No extension, only sites you allow.10
  2. 6422Mobio.github.benkaiser/mobAn AI-first personal CRM you run in natural language: contacts, reminders, notes, and more.10
  3. 6423Mob (Demo)io.github.benkaiser/mob-demoEphemeral no-signup demo of Mob, an AI-first personal CRM you run in natural language.10
  4. 6424McuBuddyio.github.cunjun/mcubuddyAI-native MCU debugging and observability through probes, symbols, RTOS, logs, and build tools.10
  5. 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
  6. 6426io.github.keshrath/agent-commio.github.keshrath/agent-commAgent intercommunication - messaging, channels, shared state, and real-time events10