Conducted MCP

Conducted MCP

一个 MCP 服务，帮助 AI Agent 以严谨团队的方式规划和跟踪软件项目——而且它本身就是用所提供的方法论构建的。

Conducted MCP 将 Conducted Development——一种轻量、以意图为驱动的方法论——提供给任何支持 MCP 的 Agent（Claude Desktop、Cursor 等）。它是一个无状态的顾问 + 验证器：不保存项目数据，也不接触任何文件或 git。所有 I/O 都由 Agent 完成；服务提供判断——验证这份产物、是否该开站会、这个阶段的流程是什么、这个决定是否应该记入日志。

**差异化优势：**本仓库自己的 work/ 文件夹——目标简报、意图文档、决策日志和周期站会记录——都是按照此工具实现的方法论产出的。这是流程的实证，而不是样例。

---

功能

连接的 Agent 可按需获取：

• 引导式启动（kickoff 提示词 + kickoff_questions / kickoff_plan 工具）——通过分支式问答，为全新项目或现有代码库搭建规划结构。对于现有代码，Agent 会检查仓库，服务会预先填写答案，让人类只需确认，而不必从头编写。
• 严格的产物验证（validate_artifact）——提交目标简报 / 意图文档 / 会话日志 / 站会记录，获取 { valid, missing, warnings }。
• 阶段流程（next_procedure）——按顺序排列的步骤、首先要阅读的内容，以及 Agent 在循环中所处位置对应的升级处理节点。
• 机械式规则检查（standup_due、evaluate_gate、decision_log_guidance）——独立实践者最常忽略的例行事项；服务会根据提供的事实做出无状态判断。

方法论的指南、模板和约定以只读资源形式提供（conducted://guide/*、conducted://template/*、conducted://conventions），让 Agent 能够在会话中学习规则。

---

为什么这样构建（Model C）

服务无法强制执行——Agent 始终可以直接访问文件。因此，它不假装充当把关者，而是作为顾问：通过纯函数返回判断和流程，不产生副作用，也不需要在没有数据、无需数据认证的情况下托管任何内容。因此，它便于移植、易于测试，也可低成本地在本地或远程运行。相关推理记录在 docs/DESIGN_SKETCH.md 中，最终确定的权衡取舍记录在 DECISIONS.md 中。

---

快速开始

已发布到 npm，包名为 conducted-mcp——无需安装即可通过 npx 运行。

将服务添加到 MCP 客户端。Claude Desktop（claude_desktop_config.json）或 Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "conducted": {
      "command": "npx",
      "args": ["-y", "conducted-mcp"]
    }
  }
}

然后让 Agent“为这个项目运行 Conducted 启动流程”，或直接调用任意工具。

或连接托管端点（无需安装）

一个无状态的 Streamable HTTP 端点在 Cloudflare Workers 上运行——通过 URL 连接，无需安装：

{
  "mcpServers": {
    "conducted": {
      "url": "https://conducted-mcp.jonathanmostov.workers.dev/mcp"
    }
  }
}

由于服务是无状态的且不保存数据（Model C），该端点无需身份验证即可安全运行，并由速率限制提供保护。

---

演示

请参阅 docs/DEMO.md，了解 kickoff 流程的真实记录——入口提示词、分支式访谈和阶段流程，均从运行中的服务逐字记录。

---

开发

npm install
npm run build     # bundles the methodology text, then strict tsc
npm test          # vitest
npm run lint      # eslint + prettier
npm start         # run the stdio server

该服务使用官方 @modelcontextprotocol/sdk 编写，采用 TypeScript、ESM 和严格模式。项目布局和约定请参阅 CONTRIBUTING.md。

---

仓库中的方法论

• work/goal-briefs/ — 推动本项目构建的目标简报
• work/intent-docs/ — 每个工单一份，即每个会话的约定
• work/standups/ — 周期关卡站会
• work/decision-log.md — 仅追加的决策记录
• AGENT_CONVENTIONS.md — 每个会话的运行方式，与模型和工具无关

---

许可证

MIT © 2026 Jonathan Mostov