关于 Pathmode
Pathmode 是一个 MCP 服务,可在编码 Agent 实现请求前检查尚未明确的产品决策。它以确定性方式执行六项预检,无需账户、API 密钥或模型调用;团队可同步意图和证据。
主要功能
- 01六项确定性就绪度检查
- 02无需配置或模型调用
- 03将规格保存为仓库中的 intent.md
- 04通过 PATHMODE_API_KEY 同步团队数据
适用场景
- 01在实现前发现未决产品选择
- 02根据编码请求起草意图规格
- 03在分支上复现就绪度判定
MCP 相关
该 MCP 服务让编码 Agent 使用 Pathmode 的意图预检工作流。README 介绍了通过 MCP 客户端安装和使用软件包。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @pathmode/mcp-serverPATHMODE_API_KEY密钥Optional: Your Pathmode API key for team features (dependency graph, workspace context). Get one from Settings > API Keys in the Pathmode app.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
22收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | string | 否 | 按状态筛选:draft、validated、approved、shipped、verified |
| include_evidence | boolean | 否 | 内联此意图引用的实际证据条目(已截断)。默认为 false — 默认响应仅包含无需获取数据的 evidenceSummary,以降低常规调用的成本。 |
详细介绍
@pathmode/mcp-server
在编码 Agent 开始构建之前,找出请求中尚未明确的产品决策。这是一项确定性的预检:六项经过校准的检查,无需密钥,也不调用模型。
本仓库也在实际使用同一工作流:阅读其 intent.md。
本仓库是该软件包的问题跟踪仓库,而不是其源代码仓库。 服务在 Pathmode 的私有 monorepo 中开发,并从该仓库发布到 npm。此仓库之前曾存放一份手动复制的源代码快照,但它比已发布的软件包落后了好几个版本。现在已不再保留该副本,因此这里没有过时内容可供查看。
如需查看代码,请解压已发布的 tarball:
npm pack @pathmode/mcp-server && tar -xzf pathmode-mcp-server-*.tgz
安装
将以下内容添加到项目根目录中的 .mcp.json:
{
"mcpServers": {
"pathmode": {
"command": "npx",
"args": ["@pathmode/mcp-server"]
}
}
}
无需账户或 API 密钥。规范以纯 Markdown 格式存放在你仓库中的 intent.md 里,由你掌控。设置 PATHMODE_API_KEY,即可在团队内同步意图和证据。
查看实际效果
在 Fieldnote(一个虚构的计费应用,其工单要求添加一个 Cancel plan 按钮)中,对于一条指令 implement FN-412,使用此服务的 Agent 没有编写任何产品代码。它发现仓库中唯一的取消相关代码是为退款编写的,若用于取消,会扣除每位取消用户已付费的天数;随后它起草了一份包含四项待决产品选择的 intent.md,并停止执行:预检以 6/6 通过,但仍受这些选择阻碍。
记录的运行过程列出了每次工具调用;在该分支上运行 npx -y @pathmode/cli preflight 可复现这一判定。
链接
- npm 软件包:已发布的服务,始终保持最新
- IntentSpec:本服务所编写的
intent.md文件所遵循的开放规范 - intent.md 配置文件:
check_intent_readiness据此评分的六项检查 - Pathmode:面向团队的平台
- 已收录于 MCP registry
问题
错误报告和功能请求请提交至 Issues。
请附上 npx @pathmode/mcp-server --version 的输出,以及你正在使用的客户端。
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。