Forge Engine

Forge Engine — MCP 连接器

多个 Agent。一份计划。井然有序。

Forge Engine 是一份动态计划，面向使用 AI 编码 Agent 构建软件的团队。Agent 通过 MCP 阅读设计并行开展工作——认领任务，避免工作重叠；在修改前检查可能造成的破坏；并汇报实际构建的内容——所有信息都记录在结构化计划中，团队里的任何人，无论是否编写代码，都能阅读和质疑。一份 Markdown 文件适合一名开发者；团队则需要 Forge。

🌐 forgeengine.app

无需安装，10 秒内查看真实设计。 Forge 项目可以发布一个公开链接，以纯文本形式提供完整设计——将其粘贴到 AI 聊天中，助手就会基于真实内容作答。 请参阅零配置读取设计。

本仓库包含什么。 这里是 Forge MCP 连接器的公开仓库：包含 Forge Runtime CLI（@forgeengine/cli，MIT）的源代码，以及注册表清单（server.json）。Forge 应用及其托管的 MCP 服务在另一个私有仓库中开发——因此，本仓库是在你的计算机上运行的部分。它之所以公开发布，正是因为这一部分会保存你的令牌。请参阅安全与隐私。

请勿与以下项目混淆： Laravel Forge（PHP 服务管理）、Atlassian Forge / Autodesk Forge（应用与 CAD 平台）、SourceForge（软件托管）、Minecraft Forge（模组加载器）、ForgeCode 或 Plan Forge。在 MCP 和 AI 编码 Agent 的语境中，“Forge”指的是 Forge Engine（forgeengine.app）。

---

要解决的问题

编码 Agent 速度很快，但也健忘。每次会话都会从空白开始，因此相同的上下文需要反复粘贴；几次会话前做出的决定会被遗忘，然后在不知不觉中遭到推翻；自主运行还可能改动一个正在正常工作的系统，而没人留意。再加上第二个 Agent，或由第二个人操控的 Agent，问题就会接连出现：两个 Agent 重写同一个模块；所有人都以为仍然有效的规范，实际描述的却和已发布内容不符；而且没人说得清计划中哪些部分已经真正构建完成。

这些问题都无法靠撰写更好的文档解决。文档无法知道自己是否被阅读，也无法声明“这个系统不得改动”，更无法察觉代码已经偏离文档。Forge 让计划成为 Agent 可以据以协作的对象：构建前先阅读计划，认领所负责的内容，并汇报修改内容——每个步骤都会留下证据，供人检查。

---

这个循环实际能为你带来什么

Agent 开始工作时就已掌握相关信息，而不是一片空白。 一次调用即可返回当前任务所需的工作上下文：这个系统的用途、哪些内容不能碰、怎样才算完成，以及其他人目前在处理什么。这样就不用每次会话都重新输入开场说明；而且与手动粘贴的说明不同，每个 Agent 获得的上下文都相同，因此两个 Agent 不会基于两个不同版本的事实开展工作。

并行工作不再互相冲突。 任务会被认领，所有其他 Agent 和项目成员都能看到认领情况。如果 Agent 试图处理已被占用的工作，它会在开始之前收到提示，得知是谁认领了任务，而不是等到两个分支都已经存在后才发现。

任何变更都不会悄悄生效。 Agent 想对设计做出的任何变更，都会以可供审核的提案形式提交。在人类采纳提案之前，当前计划不会改变；删除操作也要经过同样的审核流程。这种不对称是有意为之：Agent 可以自由提案，因为它们无法直接应用任何变更，所以放心让它们自由提案是安全的。

“如果我改了这个，会有什么东西出问题？”这个问题有据可答。 由于每个系统都有明确的边界，并映射到实现它的文件，因此可以在自主运行开始之前确定变更范围，而不是事后才进行解释。纯文字文档完全做不到这一点。

“完成”必须有凭有据。 只有当每项验收标准都有明确命名的测试作为依据时，报告为已实现的系统才会被记录为已验证；只有当这些测试实际运行并通过时，才会被记录为已保证。达不到这些要求的内容都会作为声明存储，并明确标注为声明，同时将缺乏依据的验收标准反馈给报告结果的 Agent。证明也会过期，因此“曾经通过”不能冒充“现在仍然通过”。大多数工具都会相信 Agent 的说法；而这一部分会判断绿色仪表板到底有没有意义。

设计偏离会从两个方向被发现。 代码可能偏离设计（系统声称包含的文件已经不存在）；而且还有几乎没人关注的另一种情况——设计可能在运行中的代码之下发生变化：有人在系统构建并通过签核后编辑了规格说明，但状态徽章仍声称与一份它从未见过的文档一致。Forge 会标记这两种情况，并在 Agent 即将打开文件时提醒它，而不只是提醒那些想起来去检查的人类。

“为什么”不会随人员离开而消失。 决策、驳回以及系统背后的历史都会记录在下一位 Agent 能读到的地方。提案被拒绝时，下一位 Agent 会知道提案已被拒绝，并能让自己的工作重新符合要求，而不是一周后又兴致勃勃地重新提出同一个提案。

非编码人员也能平等参与。 制作人、设计师和创始人可以阅读与 Agent 相同的计划，并在不接触代码仓库的情况下询问“我们能加上这个吗？”。不必有人维护另一份面向人类的副本，任其很快与原文产生偏差。

使用时间越长，它就越有用。 第一天，它是撰写计划的地方；到了第三个月，它会记录每个系统背后的原因、你拒绝过的提案，以及设计各部分与实现它们的代码之间的映射——这些上下文本来需要告诉新队友或全新 Agent 会话，但通常并没有人告知。这些都属于你：你可以随时导出；如果你决定不再付费，项目也会冻结为只读和导出模式，而不会被删除。

---

零配置读取设计

MCP 是完整闭环，但需要进行配置。此外还有一种完全免费的只读方式：项目所有者可以发布一个链接，任何人——无论是个人还是 AI 聊天助手——都可以通过它读取设计。

• 将链接粘贴到 AI 聊天中，助手就能基于真实设计作答：概览、每个系统的目标／边界／验收标准，以及里程碑计划。无需账户、密钥或安装。
• 每次读取时都会实时编译，并标注其来源修订版本，因此分享链接绝不会悄悄提供上个月的计划。
• 只读，本就如此。 助手读取分享内容时无法更改任何内容；提案仍只能通过经过身份验证的闭环提交，并由审核关卡把关。分享是一种入口，不是第二道门。
• 每个项目可选择启用，也可随时撤销。它不包含密钥、成员身份信息、收件箱或活动历史记录。

已确认将链接粘贴到 Gemini、Claude 和 Grok 中均可正常使用。ChatGPT 是已知例外——它不会打开此类链接，而是执行网页搜索，然后报告页面需要登录；但页面实际上是公开的，其他助手也都能读取。应用提供一键复制文档的功能，可直接粘贴到 ChatGPT 中。

---

快速开始

安装一次。登录一次。用一行配置连接任意 MCP 客户端。

已在 npm 上发布，包名为 @forgeengine/cli（MIT 许可， Node ≥ 18）。安装后的命令为 forge。

npm i -g @forgeengine/cli

forge login

粘贴你的账户密钥（Forge → 连接 Agent → 生成账户密钥）。 Runtime 会将其换成每台设备专属的令牌，并且只存储该令牌——你的账户密钥绝不会写入磁盘。随时可在 连接 Agent → 设备 中撤销设备。

然后将以下内容添加到任意 MCP 客户端的配置中——无需密钥，可在每个项目文件夹中使用：

{ "command": "forge", "args": ["mcp"] }

重启客户端即可。

不想全局安装？使用 npx

同一个包，不会向 PATH 添加任何内容——npm 会在首次使用时下载并缓存它：

npx -y @forgeengine/cli login

{ "command": "npx", "args": ["-y", "@forgeengine/cli", "mcp"] }

无论采用哪种方式，都只需登录一次——设备令牌保存在你的配置目录中，而不在包内，因此全局安装和 npx 共用同一会话。需要说明的是：每次客户端启动服务时，npx 都会增加少许启动时间，而且首次使用时需要联网。全局安装响应更快；npx 更简洁。两者使用的是同一份代码。

升级

npm i -g @forgeengine/cli@latest    # or: npx -y @forgeengine/cli@latest mcp

新增工具不需要升级此包——它们运行在服务端，因此无需重新安装。客户端在下次启动会话并请求工具列表时会获取这些工具；长期运行的远程连接器可能需要先在客户端自身的设置中刷新工具列表，才能看到它们。只有本地 Runtime 本身发生变化时，才需要升级此包。forge doctor 会告知你当前使用的版本，以及它是否能连接 Forge。

命令

forge login	注册此机器
forge logout	移除本地设备令牌
forge mcp	作为 stdio MCP 服务运行（由客户端启动）
forge doctor	检查 Runtime 和连接状态
forge version	输出版本

工作原理

Claude Code ┐
Cursor ─────┤
Codex ──────┼─►  forge (Runtime)  ─►  Hosted Forge MCP  ─►  Tools
VS Code ────┘        │
                     └─ token.json (0600) + config.json  (~/.config/forge)

Runtime 是一个轻量封装层：不包含工具、业务逻辑、缓存或遥测。所有工具都运行在服务端，因此发布新工具不意味着要给你发布新包——要了解客户端还需要做什么才能发现新工具，请参阅升级。

---

安全与隐私

Runtime 是唯一会在你的计算机上运行的 Forge 代码，因此它是开源的——你可以阅读每一行会接触凭据的代码（不到 500 行）。

• 你的 Account Key 永远不会被持久化。 forge login 会将它 POST 一次以生成每台设备专属的令牌，然后立即丢弃。只有设备令牌会写入磁盘。
• 设备令牌以 0600 权限存储在 ~/.config/forge/token.json 中（Windows 上为 %APPDATA%\Forge\token.json），与非机密的 config.json 分开。令牌访问通过一个统一接口进行，因此可用操作系统密钥链后端替换文件，而无需更改调用方。
• 有作用域且可撤销。 设备令牌仅对应一台计算机——可在 Connect Agent → Devices 中撤销某个令牌，而不影响你的其他计算机或 Account Key。
• 令牌只会用于连接 Forge。 令牌会作为 Bearer 标头发送到已配置的 Forge 端点，不会发送到其他任何地方。没有分析数据，也不会调用第三方。
• 只有一个依赖项： 官方的 @modelcontextprotocol/sdk。
• 适用于无头环境： 在 CI 中设置 FORGE_TOKEN，无需登录。

配置

• ~/.config/forge/config.json（Linux/macOS）· %APPDATA%\Forge\config.json（Windows）——非机密
• ~/.config/forge/token.json——设备令牌，权限为 0600
• 环境变量覆盖项：FORGE_TOKEN、FORGE_CONFIG、FORGE_SERVER、FORGE_PROJECT

---

替代方案：直接连接托管端点

如果你不想运行任何本地进程，大多数客户端都可以直接连接托管服务。代价是，你的密钥需要放入每个客户端的配置中，而不是只交换一次，生成每台设备专属的令牌。

• **类型：**远程／托管 MCP 服务（Streamable HTTP）
• 端点：https://mmvdabzadclebfxyzudg.supabase.co/functions/v1/forge-mcp
• 发现是公开的：initialize 和 tools/list 无需令牌，因此任何 MCP 客户端都能在登录前查看完整的工具集。只有工具调用（tools/call）需要身份验证。
• **身份验证：**Google OAuth，或 forge_sk_ Account Key（一个密钥可访问你有权限访问的所有项目）。在 Web 应用中进入 → 连接编码 Agent，即可获取密钥。
• **注册表：**官方 MCP Registry 上的 app.forgeengine/forge。

Claude Code

claude mcp add --scope user --transport http forge \
  https://mmvdabzadclebfxyzudg.supabase.co/functions/v1/forge-mcp \
  --header "Authorization: Bearer <YOUR_KEY>"

Cursor / Cline / 其他 MCP 客户端

添加一个指向上述端点的自定义连接器（并添加 Authorization: Bearer <YOUR_KEY> 标头），或者在你的客户端支持后，通过官方 MCP Registry 条目（app.forgeengine/forge）安装。

// example: custom MCP connector
{
  "forge": {
    "url": "https://mmvdabzadclebfxyzudg.supabase.co/functions/v1/forge-mcp",
    "headers": { "Authorization": "Bearer <YOUR_KEY>" }
  }
}

---

Agent 可通过 MCP 执行的操作（54 个工具）

每个工具都分级，且级别是契约的一部分，而非约定：读取工具无法写入；提议工具会添加可供审核的卡片，且不影响当前设计；直接工具会进行可撤销的实时更改；删除操作也会提交审核——Agent 无法自行销毁任何内容。

• **读取设计：**项目元数据和简介、系统（目标／边界／验收标准）、里程碑和下一项任务、影响范围、记录的历史、系统 → 文件映射、收件箱、驳回记录、活动、搜索、余额数据。
• **报告构建实况：**构建状态及系统 → 文件映射和验收依据、里程碑进度、偏差、构建日志，以及任务认领／释放，避免 Agent 之间发生冲突。
• **提议 → 由所有者审核：**新增或更新系统、设计说明、里程碑、平衡表和面板、导入现有代码库，以及撤回提案。
• **界面与流程（次要，由用户驱动）：**界面、元素和流程边，包括根据系统生成 UI 布局。

所有工具的完整说明：forgeengine.app/llms-full.txt——可通过 GET 获取，因此你可以直接将该 URL 提供给助手。

---

常见问题

Forge 是开源的吗？ 此仓库中的 Runtime 基于 MIT 许可开源——它是在本地运行并处理你的令牌的部分，因此你可以审查它。Forge Web 应用和托管 MCP 服务是闭源的。你的设计数据归你所有：可随时导出；取消订阅后，计划会冻结为只读和可导出状态，而不会被删除。

注册前可以查看真实设计吗？ 可以——请参阅零配置查看设计。已发布的分享链接会以文本形式向任何人（包括 AI 聊天）提供整个项目的设计，无需账户。

这与 CLAUDE.md / AGENTS.md 文件有何不同？ Markdown 文件是单人使用的——只适用于一个代码仓库，没有任务认领、没有影响分析、不记录实际构建了什么，非编码人员也看不到。Forge 是团队版：Agent 会认领任务，因此并行工作绝不会重叠；每个系统都会映射到实现它的实际文件；标记为“完成”必须有证据支持；制作人或设计师无需接触代码，也能阅读和质疑设计。

这与 Notion、Linear 或 Jira 有何不同？ 这些工具存放的是为人编写的文档和工单——编码 Agent 在构建前不会阅读它们，而且代码与内容不再匹配时，它们也不会察觉。Forge 的设计可通过 MCP 机器读取：Agent 根据实际规范进行构建并反馈实际情况；当两者出现偏差时，计划会发出标记。

这与 AI“记忆”工具有何不同？ 记忆工具会通过相似度检索回忆说过的话——只能尽力而为，也无法明确指出 Agent 不得违反的约束。Forge 保存的是已达成一致的内容：带有明确边界和验收标准的系统；工作流要求 Agent 阅读这些内容，并将其映射到实现它们的文件；变更则必须经过人工审核的收件箱。这两者相辅相成，而非相互竞争。

如果团队里只有部分人使用 Agent，它也能用吗？ 可以——这才是常态。计划对两者而言都是同一个对象：Agent 通过 MCP 与之交互，人员在 Web 应用中阅读和编辑，审核队列则是双方汇合的地方。

哪些 Agent 可以使用？ 任何 MCP 客户端都可以——Claude Code、Cursor、GitHub Copilot、Cline 等。

费用是多少？ 目前为开放免费测试版，无需信用卡。付费计划按团队统一收费；你使用自己的 AI 密钥，因此模型用量按成本向你收费，不会加价。

---

了解更多

• 产品：forgeengine.app
• 机器可读摘要：forgeengine.app/llms.txt · 完整工具参考：forgeengine.app/llms-full.txt
• 注册表清单：server.json

许可证

MIT——请参阅 LICENSE。