mcpField
R
RoadRaven

RoadRaven

本地服务
shuffzord.github.io生产力92 天前更新
代码仓库访问官网

关于 RoadRaven

RoadRaven 的 MCP 服务连接 Claude Code 等 MCP 主机与正在运行的 RoadRaven 桌面应用，让 Agent 管理项目路线图。它提供 21 个工具，并为 Claude Code 附带两个工作流技能。

主要功能

  1. 01读取已打开的路线图
  2. 02创建、编辑、移动和删除节点
  3. 03设置路线图节点状态
  4. 04两个 Claude Code 工作流技能

适用场景

  1. 01将需求整理为分阶段路线图
  2. 02执行路线图任务并更新其状态

MCP 相关

本地 stdio MCP 服务提供 21 个工具，用于读取和编辑运行中的 RoadRaven 应用内的路线图。它通过 127.0.0.1 上的 WebSocket 连接。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "shuffzord-roadraven": {
      "command": "npx",
      "args": [
        "-y",
        "@roadraven/mcp"
      ]
    }
  }
}
启动命令npx -y @roadraven/mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@roadraven/mcp0.9.2

工具

21

收录的工具列表 · 更新于 2 天前

参数类型必填说明
metaobject否任意的键值元数据，例如 { branch, commit, ci_run_id }
nodeIdstring是路线图中的节点 UUID
statusenum是核心节点状态not-started | in-progress | completed | blocked
expectedRevisioninteger否上次调用 getRoadmap/getNode 读取时的版本号。如果路线图此后发生更改，写入会因 stale_write 失败，而不会覆盖现有内容。

详细介绍

@roadraven/mcp — Claude Code 的 RoadRaven

适用于 RoadRaven 的 MCP 服务和 Claude Code 插件。RoadRaven 是一款本地桌面应用，可将项目计划以树状结构展示，并随着工作进展实时更新。该服务为 Agent 提供 21 个工具，用于读取已打开的路线图、创建、编辑、移动和删除节点，以及设置节点状态。该插件还提供两个技能，告诉 Claude 如何使用这些工具来规划并执行实际工作。

源代码可用，FSL-1.1-MIT。

应用必须处于运行状态

每个工具都通过 127.0.0.1 上的本地连接与 RoadRaven 桌面应用通信。应用关闭时，工具会返回 app_not_running；没有打开路线图时，会返回 no_file_loaded。应用只会打开或保存你当前正在处理的文件，因此请求访问其他路径时会返回 path_not_permitted。请先安装应用：参见安装。

它在你的计算机上执行的操作

  • 通过 npx 从 npm 下载并运行 @roadraven/mcp，并固定为与插件完全一致的版本，将其作为本地 stdio MCP 服务运行。
  • **读取一个文件：**RoadRaven 用户数据文件夹中的 event-api.json（Linux 上为 ~/.config/RoadRaven，Windows 上为 %LOCALAPPDATA%\RoadRaven）；桌面应用会在其中写入本地端口。
  • 只连接到 RoadRaven 桌面应用，通过 127.0.0.1 上的 WebSocket 读取和编辑已打开的路线图。不向其他任何地方发送数据，也不收集遥测信息。
  • **只有在你自行运行 npx @roadraven/mcp init 时才会写入文件：**它会询问是否将简短的 RoadRaven 说明添加到 CLAUDE.md，并会事先征求同意。
  • 这些技能是给 Claude 的指令；它们不会自行运行任何操作。

安装

有三种方式，按从简单到复杂排列。

**设置向导。**启动 RoadRaven。首次运行时，设置向导会检测 Claude Code 和 OpenCode，并允许你一键注册此服务。点击顶部栏中的 ⚙ 按钮可再次打开向导。如果下方的 Claude Code 插件已安装，向导会优先使用该插件。

**Claude Code 插件。**需要 Node.js >= 24。在 Claude Code 中运行：

/plugin marketplace add Shuffzord/RoadRaven
/plugin install roadraven@roadraven

**其他任何 MCP 宿主。**需要 Node.js >= 24。请固定为与你安装的应用相匹配的版本（应用会在主版本或次版本不匹配时发出警告）：

claude mcp add -s user roadraven -- npx -y @roadraven/[email protected]

如需将简短的 RoadRaven 说明添加到 CLAUDE.md（它会询问是使用当前项目还是 ~/.claude/CLAUDE.md），请运行 npx -y @roadraven/[email protected] init。

技能

技能仅随 Claude Code 插件安装提供。使用设置向导和 npx 的方式只能获得工具，不包含技能。

roadraven:orchestrate 会将请求转化为路线图树（目标、阶段、任务），为每个阶段编写简报，将各阶段交给子 Agent，重新运行项目自身的检查以验证结果，并在你查看进度时持续更新节点状态。

Plan the CSV export feature as a roadmap in RoadRaven and run it phase by phase.

roadraven:work-node 用于完成单项任务：认领节点、将其状态设为进行中、将进度记录到备注中、只修改简报中列出的文件、先通过失败测试证明修复有效、运行检查、汇报，并设置最终状态。

Pick up the first not-started node in the open roadmap, do the work, and keep its status current.

这两项技能都会从项目的 README、软件包清单或 CI 配置中查找测试、lint 和构建命令，因此适用于任何编程语言。如果应用未运行，它们会询问你一次是否启动应用，然后改用 Markdown 工作日志，并说明这一点。

了解更多：MCP 安装指南， 插件编写指南。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。