Concord MCP
让 Claude Code、Codex、Cursor 等编码代理互相实时通信，在编辑前发现工作重叠、共享决策并移交任务。
- Star 数
- ★ 401
- 最近更新
- 2 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 67/100 · 存在缺口
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 开始前需要
- 典型场景
- 多名开发者在同一仓库并行运行 Claude Code 与 Codex，需要代理在编辑前互相发现文件认领冲突
- 主要局限
- 不支持真实交付时静默重路由，消息会立即失败，需要自行检查 adapters status
- 源码审查
- 67/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Concord MCP 是一个开源、本地优先的 AI 编码代理通信与协调层。它通过一个 MCP 服务器让 Claude Code、Codex、Cursor、Gemini CLI 和 Grok Build 等代理互相发现、发送可回复的直接提示、认领文件与任务、并在会话结束后保留任务记忆。所有共享状态保存在仓库根目录 .concord/ 下的本地 SQLite 数据库中，并生成 HANDOFF.md、REVIEW_PACKET.md 等人类可读工件。它不是编排器、代码审查器或自主代理，而是围绕现有代理的共享工作状态层。代理通过五个 MCP 工具交互，人类与 CLI 型代理也可通过 concord 命令行访问同一工作区。
安装后运行 concord setup，会在本地创建 .concord/ 工作区，并为 Claude、Cursor、Gemini、Grok、Codex 注册 MCP 服务器、写入工具指令。代理通过五个 MCP 工具协作：start_work 注册在线状态并认领任务、检查范围重叠；inspect_work 读取工作区/任务状态与收件箱及提示/回复线程；update_work 记录上下文或用 operation: "prompt"/"reply" 向其他代理发送实时消息；transfer_work 处理分配、接受、移交等所有权变更；finish_work 记录证据并将任务标记为可审查或完成。所有写入带 agent_id 以保持在线状态，生命周期变更用 expected_version 做乐观并发控制，所有权变更记录在只追加的审计历史中。CLI 提供 concord status、who、tasks、handoff、review-packet、dashboard（实时 TUI）等命令。
- 多名开发者在同一仓库并行运行 Claude Code 与 Codex，需要代理在编辑前互相发现文件认领冲突
- 团队希望会话结束后任务决策与上下文仍保留在本地而非丢失
- 开发者想用一个代理构建功能后把任务移交给另一个代理，并附完整交接证据
- 需要独立审查者基于 REVIEW_PACKET.md 中的范围、测试、风险做代码审查
- 个人开发者用 concord dashboard 实时查看各代理的在线状态、任务与告警
如何安装或部署这个 Agent？
通过 npm 全局安装，然后在目标仓库中初始化：
bash
npm install -g @concord-ai/concord-mcp
cd /path/to/your/repository
concord setup无需 API 密钥；setup 会创建本地 .concord/ 工作区、注册 MCP 服务器并写入指令文件，可安全重复运行。随后重启代理客户端一次即可启用实时通信。可用 --no-adapters、--no-mcp、--require-adapters 调整行为。
如何使用这个 Agent？
重启客户端后，让两个代理在同一仓库工作，它们即可互相发现并交换消息。人类可随时用 CLI 查看：
bash
concord status
concord dashboard
concord tasks
concord handoff <task-id>
concord review-packet <id>
concord adapters status用 --repo 或 --workspace 从任意位置选择仓库或工作区；无通用的 /concord 斜杠命令，各客户端通过 MCP 工具与安装的指令协作。升级用：
bash
npm install -g @concord-ai/concord-mcp@latest
concord --version这个 Agent 有哪些优点和局限？
- 跨代理运行时（Claude Code、Codex、Cursor、Gemini CLI、Grok Build）直接通信，无需人类中转上下文
- 本地 SQLite 存储，.concord/ 默认加入 .gitignore，代码与任务内容不出本机
- 带 expected_version 乐观并发控制与只追加审计历史，避免多代理同时改状态
- 实时 TUI dashboard、adapters status 可达性矩阵与 stale claim 检测等运维工具齐备
- 不支持真实交付时静默重路由，消息会立即失败，需要自行检查 adapters status
- 仅在共享同一本地 checkout 时有效，不是托管同步服务或多仓库方案
- 默认向 getconcord.ai 发送遥测（可禁用），服务器端存储的 IP 与国家码目前无自动过期
- 需要为每个支持的客户端重启会话并安装适配器，交付能力取决于各 harness 的状态
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Concord MCP 当前 | 67 · 存在缺口 | — | ★ 401 | 2 天前 | TypeScript | Codex · Claude Code |
| MCO | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 531 | 1 个月前 | Python | Codex · Claude Code |
| AWS Agent Toolkit | 58 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 2.8k | 1 天前 | Python | Codex · Claude Code |
| Emulo | 78 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 293 | 2 天前 | HTML | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
数据流透明度是亮点：README 与 SECURITY.md 详细列明遥测内容与禁用开关（CONCORD_TELEMETRY_DISABLED / DO_NOT_TRACK），并有 CONCORD_ALLOWED_ROOTS 限权与本地 SQLite 存储声明（least_privilege/data_flow_transparency 得分较高）。扣分点：默认向 getconcord.ai 发送遥测且服务器端 IP/国家码无自动过期（sensitive_data_handling 扣分）；concord setup 会写入大量客户端配置文件（CLAUDE.md、AGENTS.md、~/.codex/config.toml 等），仅描述为合并式，未见确认或 dry-run 机制（external_effects 仅 1）；setup 安装全局适配器默认执行；依赖仅列于 package.，无审计/锁文件证据（dependency_security 仅 1）；rollback 有 uninstall/doctor 与 append-only 审计史（2）。发布者未验证，但身份信息（作者、仓库、OIDC 可信发布）在文件内一致，故 attribution 给 2 而非更高。
README 描述乐观锁 expected_version、幂等键、不可达立即失败、hook-only 降级路径明确声明，failure_messages 有据（2）。依赖可用性：better-sqlite3 本地、无远程强依赖（2）。重大扣分：self_consistency 仅 1 —— README 列出五个工具 start_work/inspect_work/update_work/transfer_work/finish_work，但提供的测试代码引用 claim_work、handoff、register_agent、review_ready 等另一套工具名，文档与可见代码命名不一致，无法在静态审查中调和。
受众与场景描述充分：五类客户端 + 任意 MCP 客户端 + CLI 用户，分层清楚（3）。能力边界极佳：'What this is / is not' 明确排除编排器/审阅器/云同步（3）。trigger_precision 得 2：交付路径按客户端说明（斜杠命令不存在、hook-only 限制声明），但无法验证指令写入后行为。environment_fit 得 2：Node>=22.12 要求明确、worktree 共库逻辑说明、CONCORD_REPO_ROOT 优先级清楚，但五客户端兼容仅靠文档断言。
信息架构与安装说明优秀：README 结构完整、setup 变更折叠说明、CLI 全列表（各 3）。license 文件齐全且与 package. 一致（3）。known_limitations 部分：pre-1.0 声明、hook-only 限制、delivery 依赖 harness（2）。重大扣分：naming_stability 仅 1（上述工具名不一致）；无 CHANGELOG 文件，versioning 仅靠 npm/CI tag 机制（1）；维护责任有 CONTRIBUTING/SECURITY.md/CI 但无明确维护者承诺或响应 SLA（2）。
output_usability 得 2：HANDOFF.md/REVIEW_PACKET.md/WORK_STATE. 为人类可读工件，dashboard 只读 TUI 设计合理，但无实际输出样例可核。marginal_value 得 2：跨 harness 消息 + 文件认领冲突防护解决真实痛点，'Without/With Concord' 对比表有说服力，但与简单 markdown/git 约定的差异需运行验证（docs/why-not-markdown.md 未提供）。cost_benefit 得 2：一个 MCP server + 本地 SQLite 成本低，但 setup 写多配置文件与全局适配器安装增加运维面。
claim_traceability 仅 1：核心承诺（实时消息、冲突检测、审计史）在提供的文件中只有测试片段覆盖（artifacts 写出、身份解析），五工具行为本身无源码可见。cross_source_corroboration 仅 1：README/SECURITY 相互印证遥测声明，但与测试代码的工具名互相矛盾，削弱整体佐证。fact_inference_separation 得 2：README 区分了陈述与限制（'Live delivery depends on the receiving harness'、best-effort 交付），多数表述可归因，但 demo/性能声明无执行证据，置信度整体为 low。
- 默认开启遥测并向 getconcord.ai 发送操作元数据；如不希望数据外发，请先设置 CONCORD_TELEMETRY_DISABLED=1 或 DO_NOT_TRACK=1 再使用。
- concord setup 会修改多个客户端配置文件并默认安装全局适配器；运行前请备份这些配置，考虑 --no-adapters / --no-mcp 最小化变更。
- README 声明的五个工具名与提供的测试代码中出现的工具名不一致，静态审查无法确认 API 稳定性；在 0.x 阶段预期能有破坏性变更。
- 遥测的服务器端 IP 与国家码字段目前无自动过期策略；安全修复仅针对最新版本（pre-1.0）。
- 未提供 lockfile 或依赖审计证据，请在受控环境中自行审查 better-sqlite3 等原生依赖。