内容
# Concord MCP
[](https://www.npmjs.com/package/@concord-ai/concord-mcp)
[](https://www.npmjs.com/package/@concord-ai/concord-mcp)
[](https://github.com/Get-Concord-AI/concord-mcp/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@concord-ai/concord-mcp)
[](./LICENSE)
**编码代理的共享工作状态。** Concord MCP 为 Claude Code、Codex、Cursor 和其他支持 MCP 的编码助手提供了一个共享的工作日志。代理可以认领工作、留下交接信息，并生成可供审核的 packets，然后再打开 PR。
> ⚠️ 早期版本，正在积极开发中。v0 版本包含三个 MCP 工具：`claim_work`、`handoff` 和 `review_ready`。
## 为什么
代理在独立工作时效果良好，但它们的计划、假设和决策只有在 PR 时才可见。团队目前通过 `AGENTS.md`、交接文件、工作树和自定义脚本来解决这个问题。Concord 提供了最小但有用的版本：一个本地位置，供代理在工作时记录它们正在做的事情。
## 安装
```bash
npm install -g @concord-ai/concord-mcp
concord install
```
`concord install` 会将 Concord 的工具指令写入您的客户端配置文件（`CLAUDE.md`、`AGENTS.md`、`.codex/`、`.cursor/rules/`）。然后，将 MCP 服务器注册到您的客户端，让您的代理通过 MCP 使用工具。每个客户端的设置：
- [Claude Code](./docs/claude-code.md)
- [Codex](./docs/codex.md)
- [Cursor](./docs/cursor.md)
> 没有通用的 `/concord` 斜杠命令 - 命令是客户端特定的。Concord 通过 MCP 工具和已安装的指令在任何支持 MCP 的客户端上工作。
## 三个工具
| 工具 | 何时使用 | 功能 |
| -------------- | -------------------- | -------------------------------------------------------------------------------- |
| `claim_work` | 编辑前 | 记录任务 + 预期文件/模块；标记与其他活动工作的重叠 |
| `handoff` | 完成或阻塞时 | 捕获更改内容、运行的测试、假设、决策、防护措施 |
| `review_ready` | PR 前 | 记录计划、测试、开放问题和出处 |
## 您获得的内容
SQLite 是本地真实来源（gitignored）。Concord 渲染人类可读的工件，您可以提交它们，以便在 PR 中显示：
```text
.concord/
├── concord.db 本地真实来源（gitignored）
├── HANDOFF.md 人类可读的交接信息
├── REVIEW_PACKET.md 准备好审核的证据
└── WORK_STATE.json 生成的导出（可选）
```
## 命令行界面
代理使用 MCP 工具；人类使用命令行界面。
```bash
concord init # 创建 .concord/ 工作空间
concord status # 活动工作、重叠、准备好审核、开放问题
concord tasks # 列出所有跟踪的任务
concord handoff <任务 ID> # 打印最新的交接信息
concord review-packet <ID> # 打印最新的审核 packet
concord export markdown # 重新生成 .concord/ 工件
concord doctor # 工作空间检查 + 按任务工具采用
```
## 尝试演示
```bash
pnpm demo
```
运行 [两代理重叠演示](./examples/two-agent-overlap/)：两个代理认领重叠工作（Concord 标记它），然后一个代理交接并标记任务准备好审核 - 打印生成的工件。
## 这是什么 / 不是什么
编码代理的共享工作状态和防护措施。**不是** 协调器、代码审查器、内存向量数据库或自主编码代理。
另见：[为什么不用 Markdown？](./docs/why-not-markdown.md)
## 贡献
参见 [`CONTRIBUTING.md`](./CONTRIBUTING.md) 和 [`CLAUDE.md`](./CLAUDE.md)。此仓库严格类型化（无 `any`，无类型转换），模块化，每个 PR 保持在 600 LOC 以内。良好的初始问题被标记为 [`good first issue`](https://github.com/Get-Concord-AI/concord-mcp/labels/good%20first%20issue)。
## 许可证
[MIT](./LICENSE)
MCP 市场