Roamer MCP

Name: Roamer MCP
Author: mathismeadows.com

远程服务

roamermcp.mathismeadows.com记忆与知识0今天更新

代码仓库访问官网

关于 Roamer MCP

Roamer MCP 是面向 Claude Code 用户的托管项目注册表、行为规范数据库和工程讨论串服务。可选插件增加斜杠命令工作流，用于项目简报、规范检查、功能与缺陷处理以及会话记录。

主要功能

01项目注册表与工程讨论串
02行为规范存储与审计
03带关卡的功能和缺陷工作流
04会话简报与检查点
05讨论串审查与发布说明草稿
06将项目数据导出到本地文件

适用场景

01在会话开始时查看项目背景
02按引导流程处理功能或缺陷
03审计规范覆盖情况和整洁度
04记录会话进度与未解决讨论串

MCP 相关

插件通过 HTTP 连接到托管的 Roamer MCP 服务：https://roamer-mcp.mathismeadows.com/mcp。服务端提供工具和工作流；插件额外增加十一种斜杠命令工作流。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://roamer-mcp.mathismeadows.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-mathismeadows-roamer https://roamer-mcp.mathismeadows.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-mathismeadows-roamer":{"type":"http","url":"https://roamer-mcp.mathismeadows.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-mathismeadows-roamer":{"type":"http","url":"https://roamer-mcp.mathismeadows.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-mathismeadows-roamer":{"type":"http","url":"https://roamer-mcp.mathismeadows.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-mathismeadows-roamer":{"serverUrl":"https://roamer-mcp.mathismeadows.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

roamer-mcp-plugin

面向 Roamer MCP 的可分发 Claude Code 插件。Roamer MCP 是 Roamer 项目注册表、行为规范数据库和工程讨论串 MCP 服务。了解详情，请访问 roamermcp.mathismeadows.com。

该插件是托管 Roamer MCP 服务（https://roamer-mcp.mathismeadows.com/mcp）的可选扩展。单独连接该服务即可使用所有工具和工作流；安装此插件则会添加十一个斜杠命令形式的工作流。每个工作流都有对应的斜杠命令，但在对话需要时，Claude 也可以自行调用；你不必亲自输入命令：

/roamer:orient — 会话开始时的简报（项目注册表 + 未结讨论串）
/roamer:breadcrumb — 会话结束时的检查点（注册表 + 讨论串更新）
/roamer:feature — 七步门控式功能开发工作流
/roamer:bug — 八步门控式 Bug 修复工作流
/roamer:spec-audit — 规范覆盖率审计
/roamer:spec-check — 规范卫生检查清单
/roamer:thread-scrub — 按需引导审查并处理未结讨论串积压
/roamer:release-notes — 为指定日期范围起草内部/外部发布说明，仅供审阅
/roamer:export — 以你选择的格式，将规范、讨论串和脑库快照保存到本地文件
/roamer:login — 登录，或切换此会话使用的身份
/roamer:logout — 退出此会话的 Roamer 连接
/roamer:status — 查看此连接当前登录的身份

安装

/plugin marketplace add mathismeadows/roamer-mcp-plugin
/plugin install roamer@roamer

该插件通过 HTTP 连接到托管服务，无需 Node.js 或本地安装。首次使用时，使用 /mcp 登录：选择插件的 Roamer 服务，然后按提示在浏览器中登录。之后要切换账户，请使用 /mcp → 重新验证，或选择 清除身份验证 以退出登录。

每个客户端保留一个 Roamer 连接。如果你也将 Roamer 添加为 claude.ai 连接器，或使用 claude mcp add 添加了 Roamer，Claude Code 会将同一 URL 上的插件服务和连接器视为重复项，并优先使用插件。请在 /mcp 中关闭其他 Roamer 服务，以便明确会话正在使用哪个服务。

从 1.x 升级

2.0 版本更改了插件的连接方式。1.x 会在名为 roamer 的服务下启动本地桥接程序（npx @mathismeadows/roamer-device-auth）；2.0 则会直接连接托管服务，服务名为 mcp，因此其工具名称为 mcp__plugin_roamer_mcp__<tool>。更新后：

使用 /mcp 重新登录一次（2.0 不会使用桥接程序缓存的登录信息）。
如果仍列有名为 roamer 的服务（在 /mcp 中或 VS Code 的 MCP Servers 视图中），请将其移除并重新加载。遗留的 roamer 服务可能会显示错误，但没有输出。
你对旧 roamer 服务授予的工具审批不会沿用到新名称。

数据与隐私

该插件仅连接到托管的 Roamer MCP 服务 https://roamer-mcp.mathismeadows.com/mcp。它会向该服务发送你提供给工作流的参数（例如项目名称或日期范围），以及你通过该服务读取或写入的 Roamer 内容：项目、规范、讨论串、阻碍项和会话笔记。你在浏览器中使用 OAuth 登录；插件不会查看或存储你的密码。插件不会运行任何本地代码，仅包含 Markdown 技能和服务地址。有关 Roamer 如何处理你的数据，请参阅隐私政策。