Concord MCP – AI编码代理的共享工作状态

它是什么 – 一个开源、本地优先的协调层，允许多个AI驱动的编码助手（Claude Code、Codex、Cursor、Gemini CLI、Grok Build、Goose、GitHub Copilot CLI等）在同一代码库上工作时相互通信。它运行一个由本地SQLite数据库支持的小型MCP（消息传递控制协议）服务器，并提供一组工具（start_work、inspect_work、update_work、transfer_work、finish_work）以及一个友好的CLI。

为什么重要 – 没有共享层，每个助手都会孤立地工作，导致重复编辑、隐藏冲突和上下文丢失。Concord为代理提供了一个共同的“工作区”，他们可以在其中声明文件、编辑前检测重叠、交换提示/回复、交接任务以及附加证据供以后审查。

快速入门（来自README）

# 安装全局CLI包
npm install -g @concord-ai/concord-mcp

# 进入代理希望共享的仓库
cd /path/to/your/repo

# 设置本地Concord工作区并注册MCP服务器
concord setup

concord setup 会创建一个隐藏的 .concord/ 目录，为每个支持的代理写入MCP配置文件，并（可选地）安装让这些代理能够访问服务器的小型“适配器”二进制文件。它可以安全地重新运行，还支持全局模式，该模式为用户处理的任何仓库注册Concord。

核心概念与工具

工具	作用
`start_work`	代理宣布其存在，声明文件/模块，并收到关于现有声明的警告。
`inspect_work`	读取当前工作区状态，列出存在的代理，显示过期声明，或获取持久的提示/回复线程。
`update_work`	向另一个代理发送提示或回复待处理消息。
`transfer_work`	提供、接受、拒绝或重新分配任务——这是交接的基础。
`finish_work`	将任务标记为完成，附加证据（例如 `HANDOFF.md`、`REVIEW_PACKET.md`）。

所有操作都受版本保护：同一任务版本上的并发更新被序列化，每次更改都存储在仅追加的审计日志中。

支持的代理（截至README）

Claude Code
Codex
Cursor
Gemini CLI
Grok Build
Goose
Google Antigravity
GitHub Copilot CLI
任何其他支持MCP的编码助手（通过通用MCP工具）

每个代理都有一个简短的集成指南（例如 docs/claude-code.md），解释了Concord适配器如何将必要的指令文件注入代理的配置中。

典型工作流程

设置 – 在仓库（或全局）中运行 concord setup。现在 .concord/ 文件夹包含 concord.db（SQLite真相源）和一些人类可读的工件。
声明 – 代理A调用 start_work 声明 src/app/page.tsx。Concord记录该声明。
检测重叠 – 代理B也想要同一文件；其 start_work 调用返回重叠警告。
协商 – 代理B使用 update_work 和 operation: "prompt" 请求代理A接管另一个模块。代理A通过 update_work 和 operation: "reply" 回复。
交接 – 分工确定后，使用 transfer_work 正式将新模块分配给代理B。
完成 – 工作完成后，finish_work 存储 REVIEW_PACKET.md 并将任务标记为关闭。
检查 – 人类可以运行 concord dashboard 或 concord status 查看谁在做什么、不新鲜声明以及待审查的数据包。

CLI快照（选定命令）

concord status               # 代理、任务、重叠概览
concord dashboard            # 活动的实时TUI视图
concord who                  # 列出存在的代理及其当前声明
concord tasks                # 枚举所有跟踪的任务
concord handoff <task-id>    # 显示最新的交接文档
concord review-packet <id>    # 显示任务的审查包
concord check <files...>     # 如果列出的文件被另一个活动任务声明，则退出1（在CI钩子中有用）
concord adapters status      # 显示哪些代理安装了可访问的适配器

CLI镜像了MCP工具，因此脚本或其他代理可以通过HTTP/JSON或直接通过Node包调用相同的操作。

持久性与工作区布局

.concord/
├─ .gitignore          # 捕获所有内容，使工作区保持本地
├─ concord.db          # SQLite数据库 – 唯一真相源
├─ HANDOFF.md         # 上次传输的人类可读交接摘要
├─ REVIEW_PACKET.md   # 供审查者使用的证据包
├─ events.jsonl       # 工具事件的时间顺序日志（每行一个JSON）
└─ WORK_STATE.json    # 当前工作状态的导出快照

数据库位于仓库根目录（或“全局模式”下的全局位置）。链接的Git工作树共享同一个数据库，确保跨多个检出的一致协调。

遥测与隐私

Concord将匿名使用遥测发送到 getconcord.ai（安装ID、版本号、操作名称、延迟等），但从不传输源代码、文件路径、原始消息或个人标识符。可以使用 CONCORD_TELEMETRY_DISABLED=1 或 DO_NOT_TRACK=1 禁用遥测。

它不是什么

不是自主编码代理或协调器。
不是托管同步服务；一切都在本地运行。
不是LLM的向量存储或记忆数据库。
不是代码审查工具的替代品——它只是为下游审查者打包证据。

许可证

MIT（见 LICENSE）。

底线 – Concord MCP是一个轻量级、本地托管的协调服务器，为多个AI编码助手提供共享的、冲突感知的工作区。它允许代理声明工作、检测重叠、交换提示并无缝交接任务，而无需人类作为中间人，同时保留持久、可查询的记录。

Get-Concord-AI/concord-mcp