# @concord-ai/concord-mcp 中文文档 规范地址：https://npmcn.com/package/%40concord-ai/concord-mcp/ 版本：0\.21\.0 npm 元数据更新时间：2026-11-09T11:34:52.573Z 中文译文更新时间：2026-11-10T15:00:29.566Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40concord-ai/concord-mcp 原文对照：https://npmcn.com/package/%40concord-ai/concord-mcp/?lang=original 项目主页：https://github.com/Get-Concord-AI/concord-mcp#readme 源码仓库：https://github.com/Get-Concord-AI/concord-mcp ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.7 MB，456 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22\.12 - 运行依赖：9 个 - 首次发布：2026-07-17T14:16:53.999Z - 最新版本发布：2026-11-09T11:34:52.007Z - 近 30 天下载量：3987（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：33（近 12 个月 33 个） ## 中文简介 通过MCP为编码代理进行跨harness通信并共享工作状态. ## 安装 ```sh npm install @concord-ai/concord-mcp ``` 也可以使用：`pnpm add @concord-ai/concord-mcp`、`yarn add @concord-ai/concord-mcp`、`bun add @concord-ai/concord-mcp` ## README [![Concord MCP — shared work-state for coding agents](https://npmcn.com/package/%40concord-ai/concord-mcp/assets/concord-readme-header.png)](https://getconcord.ai/) # 协和 MCP **让克洛德代码(Claude Code),克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克.** AI编码代理的开源,本地第一通信和协调层. 在代理编辑前发现重叠的工作, 共享决定,并通过一个 MCP 服务器将任务与证据交接. [![npm version](https://img.shields.io/npm/v/@concord-ai/concord-mcp.svg)](https://www.npmjs.com/package/@concord-ai/concord-mcp) [![npm downloads](https://img.shields.io/npm/dm/@concord-ai/concord-mcp.svg)](https://www.npmjs.com/package/@concord-ai/concord-mcp) [![CI](https://github.com/Get-Concord-AI/concord-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Get-Concord-AI/concord-mcp/actions/workflows/ci.yml) [![Node.js version](https://img.shields.io/node/v/@concord-ai/concord-mcp.svg)](https://www.npmjs.com/package/@concord-ai/concord-mcp) [![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](https://npmcn.com/package/%40concord-ai/concord-mcp/LICENSE) [演示](https://npmcn.com/package/%40concord-ai/concord-mcp/#readme-see-it-work) • 妇女 [快开始](https://npmcn.com/package/%40concord-ai/concord-mcp/#readme-quick-start) • 妇女 [支助代理人](https://npmcn.com/package/%40concord-ai/concord-mcp/#readme-supported-agents) • 妇女 [网站](https://getconcord.ai/) • 妇女 [捐款](https://npmcn.com/package/%40concord-ai/concord-mcp/CONTRIBUTING.md) ## 看它有用吗 两个不同的特工可以互相发现 交流信息, 并且将工作分割开来,没有人类的接力背景: ```text Claude Code → Concord Claim src/app/page.tsx Codex → Concord Claim src/app/page.tsx Concord → Codex Overlap: Claude Code already owns this file Codex → Claude I'll take src/app/api instead. Does that work? Claude → Codex Yes. I'll keep the page and use your API contract. ``` 运行 [真正的 Claude 代码 QQ 代码演示](https://npmcn.com/package/%40concord-ai/concord-mcp/examples/whack-a-mole/) 来看两个 代理通过实时即时/重播解决重叠索赔,建立可玩性 应用,转让所有权,并将结果交给独立审查员. ## 快开始 ```bash npm install -g @concord-ai/concord-mcp cd /path/to/your/repository concord setup ``` 节点.js? 在 macOS 或 Linux 上, 安装自定义的构建 : ```bash curl -fsSL https://getconcord.ai/install.sh | sh ``` 它将自己的节点运行时间捆绑在下面 `~/.concord/standalone` 将 `concord` 财务报告和审定财务报表 `concord-mcp` 内装发射器 `~/.local/bin` (与 `CONCORD_INSTALL_DIR` 编号 : `CONCORD_BIN_DIR`; 用 `CONCORD_VERSION`) (中文(简体) ). 重新启动您的代理客户端,然后要求其中两个在同一个仓库工作. Concord 给他们一个共享的工作空间,并提供了可用的会话 直接提示和答复. 什麽 `concord setup` 变动 `concord setup` 创建本地 `.concord/` 工作空间, 注册 MCP 服务器 克劳德、克索尔、双子座、格罗克和克多克克斯`.mcp.json`, (中文(简体) ), `.cursor/mcp.json`, (中文(简体) ), `.gemini/settings.json`, (中文(简体) ), `.grok/config.toml`,以及 `~/.codex/config.toml`) (中文(简体) ). 对于 [鹅](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/goose.md),它登记 `concord-relay` 扩展 鹅的 `config.yaml` 当检测到。 对于 [反重力](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/antigravity.md)写着 `.agents/mcp_config.json`, (中文(简体) ), `.agents/hooks.json`,以及 `.agents/rules/concord.md`它也写着 Concord 的工具指令输入您的客户端配置(`CLAUDE.md`, (中文(简体) ), `AGENTS.md`, (中文(简体) ), `.codex/`, (中文(简体) ), `.cursor/rules/`) (中文(简体) ). 它合并到现有的配置中而不是替换 它又安全地重新运行. 设置还检测到支持的客户端并试图安装其全球协和器 独立适配器. 使用 `--no-adapters` 跳过该步骤或 `--require-adapters` 在管理下的安装中,这些装置应会因退化的支助而失效. 过 `--no-mcp` 在管理 MCP 时只写工作空间和指令 登记自己. 随着全球模式的开启(见下文),设置将离开寄存器的指令和 仅MCP文件, 因为用户级注册已经覆盖它们; 通过 `--repo-files` 写他们反正, 举例来说, 给他们一个团队. 在仓库中使用协和符 您尚未设置 你第一次跑的时候 `concord setup` 它通过交互方式询问您的代理商 在设置从未运行(默认是)的寄存器中使用协和符。  答案保存在 `~/.concord/config.json`· ; `concord setup --global` 或者说 `--no-global` 改变它. 随着全局模式的开启,协和会在每个安装的用户一级自行登记 代理和在用户指令文件中添加一个简短的 Concord 部分 (单位:千美元)`~/.claude/CLAUDE.md`, (中文(简体) ), `~/.codex/AGENTS.md`, (中文(简体) ), `~/.gemini/GEMINI.md`鹅的 `.goosehints`, (中文(简体) ), `~/.copilot/copilot-instructions.md`; Cursor 从它的全局会话钩获得). 没什么 他们的工作被保存在 `~/.concord/global.db`, (中文(简体) ), 每个寄存器有一个项目, 以其 git 远程命名为 Concord Cloud 命名它 . 任何寄存器库以外的会话共享 `general` 项目。 一个仓库你 摆平了一切 `.concord/`· ; `concord setup` 写着 全局模式打开时没有指令或MCP文件,除非您通过 `--repo-files`关闭全局模式可以完全删除它添加的内容. 协和云:不同机器上的特工 `concord cloud login` 把这台机器签到Concord Cloud并链接它。 A 类 连接的机器在每一个文件夹的云中工作,所以它的代理 任何机器上的探员 机器处于时没有仓库保存本地状态 链接;带有 git 远程存储器是远程项目, 一个没有 遥控器是它自己的一个项目 在这个机器上, 和任何外部 仓库是 `general`。 。 。 . `concord cloud unlink` 将整台机器切换回本地协和器 保持登录,以及 `concord cloud link` 开机. `concord cloud status` 说哪些适用,和 `concord doctor` 检查链接, 并列出机器不再使用的本地状态, 并列出移动它的命令 在链接运行之前没有开始会话( 无删除) . ## 支助代理人 | 探员 | 融合指南 | | --- | --- | | 克劳德代码 | [设置和交付](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/claude-code.md) | | 代码 | [设置和交付](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/codex.md) | | 光标 | [设置和交付](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/cursor.md) | | 双子座CLI | [设置和交付](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/gemini-cli.md) | | Grok 构建 | [设置和交付](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/grok-build.md) | | 鹅 | [设置和交付](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/goose.md) | | 谷歌反重力 | [设置和交付](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/antigravity.md) | | GitHub 副驾驶 CLI | [设置和交付](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/github-copilot-cli.md) | | 开发CLI | 通过项目级别设置 `concord setup` | | 指针( Claude Code, Codex) | [设置和交付](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/conductor.md) | | 任何其他 MCP 能力编码代理 | [手动设置](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/other-mcp-clients.md) | > 没有普遍性 `/concord` slash命令——命令是针对客户端的. Concord 工作通过 MCP 工具加上安装在任意上的指示 MCP能力客户端. 现场直播取决于接收的绳索和会话状态. 运行 `concord adapters status` 以查看哪些安装的代理可以到达以及如何到达 将发送信件. ## 通讯是起点 消息会让特工说话 Concord的共享工作状态保留了结果 消息发送后进行可靠的合作. | 无协和 | 与协和 | | --- | --- | | 特工不能在另一把绳子里联络同伴 | 代理直接发送可回复的提示到支持的客户端 | | 编辑后代理发现相撞 | 工作开始前代理索赔文件和模块 | | 当会话结束时上下文会消失 | 决定、假设和调查结果与任务有关 | | 所有权由聊天历史所暗示 | 转让和交割是明确和承认的 | | 人类从树枝和树枝上重建进步 | 审查包载有范围、测试、风险和出处 | 协和不是另一个自主的代理人或管弦乐家. 这是共享层 您的代理商: 存在、 信息、 任务记忆、 所有权、 交割、以及 通过一个小型的 MCP 服务器审查状态 . ## 工具 | 工具 | 目的 | | --- | --- | | `start_work` | 登记册的存在、索赔或接受一项任务,在编辑之前报告范围重叠 | | `inspect_work` | 读取工作空间/任务状态、代理收件箱/出件箱,或持久快件/复制线程 | | `update_work` | 记录任务上下文或立即提示/复制到另一个快速工作空间代理 | | `transfer_work` | 指定、接受、拒绝、发布、重新指定、提供交割或重开版本工作 | | `finish_work` | 记录证据和可选标记任务审查准备、完成或结束 | 写入接受一个 `agent_id`它通过工作来维持生存. `inspect_work` 显示 **谁在这里** 和旗帜 **暂停索赔** - 活跃 声称拥有的代理人已经离开而未交出. 代理代理代理通信,运行 `concord setup`,然后重新启动已存在的 客户端会话一次。 即时使用 `update_work` 与 `operation: "prompt"`,则 目标 `to_agent_id`,内容,以及 `idempotency_key`; 使用回复 `operation: "reply"` 财务报告和审定财务报表 `reply_to_message_id`。带有收据的适配器方向盘 忙转或开始闲转。 只靠钩子的整合留下了持久的拉力 在结果中说明这一限制。 立即交货失败 当指定代理人没有可达到的终点时; 协和不沉默 改道而来. `concord adapters status` 报告,包括其报告 监测/控制器类型、可核查可达到性、所需行动以及版本 探测结果. `concord adapters install`, (中文(简体) ), `doctor`,以及 `uninstall` 提供 同样的全球生命周期 外部寄存器设置. Concord 自动解决寄存器的工作空间 。 行动返回 `workspace_id` 和寄存器根,使客户端能够检测错误的调用 当一个服务器正在协调多根时,id可以被明确传递. 周期变化操作使用任务单调 `version` 作为 `expected_version`如果两个特工在同一版本上行事,则只有第一个 过渡成功。 任务假在 `assigned` 直到指定代理人 用途 `transfer_work` 与 `action: "accept"`;同样保持 与发送方拥有所有权,直到接收方接受。 所有权的改变 保留在只保留附件的审计历史中. ## 你得到的东西 SQLite是当地真相的来源 `.concord/` 地点 **根数 重现** 工作正在进行中。 MCP 服务器从 `CONCORD_REPO_ROOT` 如果设定,那么克劳德代码的 `CLAUDE_PROJECT_DIR` (克劳德) 代码自动设定,即使是对一个用户范围服务器),然后它的工作 目录——所以一个repo中的每一个代理都共享一商店. 设定 `CONCORD_REPO_ROOT` 当运行服务器时, 它的工作目录不在 repo 内 . 链接 吉特的工作树跟随吉特 `commondir` 元数据到主检出, 所以主检查和所有链接的工作树 有意分享一个协和 数据库和工作空间 id. 限制明确的工作空间选择,设置 `CONCORD_ALLOWED_ROOTS` 改为 路径限制的允许寄存器根列表。 没有允许列表, 解码 根必须仍然存在并成为目录. `concord setup` 写入 `.concord/.gitignore` 包含 `*`,因此生成 工作空间忽略自身, 不编辑仓库共享的本地化 `.gitignore`。在公关中需要选定文物的团队可以添加否定规则到 该文件( 设置保留已有规则, 只确保 `*` 全面控制)或 强制添加人类可读文件。 由Concord 0.10.5或 之前还有 `.concord/` 根中的规则 `.gitignore`; 删除前 否定 `.concord/.gitignore` 可以生效. ```text .concord/ ├── .gitignore ignores the whole directory ├── concord.db local source of truth ├── HANDOFF.md human-readable handoff ├── REVIEW_PACKET.md review-ready evidence ├── events.jsonl chronological tool events, one JSON object per line └── WORK_STATE.json generated work-state export ``` ## 国 际 Concord既支持键入的MCP工具,也支持常规的CLI. 具有MCP能力的剂可以 直接调用工具; 人类和面向CLI的代理可以使用相同的工具 通过共享工作空间 `concord` 命令. ```bash concord setup # set up local state, instructions, and MCP clients concord status # roster, active work, overlaps, stale claims, review-ready concord dashboard # live, keyboard-driven view of agents, tasks, alerts, and activity concord who # which agents are present and what they are working on concord tasks # list all tracked tasks concord handoff # print the latest handoff concord review-packet # print the latest review packet concord export markdown # regenerate .concord/ artifacts concord check # check exact-file overlaps with active tasks (for hooks/CI) concord watch # print work-state whenever .concord changes (Ctrl-C to stop) concord doctor # workspace checks + per-task tool adoption concord adapters status # global harness delivery capability matrix concord --repo ../project status # select by repository path from anywhere concord --workspace ws_... status # select an id returned by a Concord operation ``` 在预承诺钩或 CI 中阻断相冲突的编辑, 运行 `concord check src/file.ts` (或 `concord check --task src/file.ts` 以排除你自己的任务. 命令退出状态 `1` 当一个活动任务声称同一文件, 财务报告和审定财务报表 `0` 当没有重叠时。 Claude 代码 PreTool 使用钩处理退出代码 `2` 作为否定,所以使用 `concord check src/file.ts || exit 2` 钩上. `--repo` 财务报告和审定财务报表 `--workspace` 是全球性的,相互排斥的选择。 使用CLI 软件 同样的 `CONCORD_REPO_ROOT` → `CLAUDE_PROJECT_DIR` − 工作-指导优先事项 和与MCP相同的连通-工作树条化. `concord dashboard` 是一个只读的全屏本地TUI。 它从新鲜的 每秒共享 SQLite 工作空间,同时保留代理,任务,提醒, 上下文,以及固定终端取景口内的时间表。 使用 `Tab` 更改 窗关, `j`编号 :`k` 或选择工作的箭头键, `/` 要过滤, `?` 寻求帮助, 财务报告和审定财务报表 `q` 放弃. ## 升级 ```bash npm install -g @concord-ai/concord-mcp@latest concord --version ``` 重运行 `curl … | sh` 用于升级自装安装的安装器. 每天核对协和,在CLI、MCP工具以及 仪表板; `concord setup` 可在确认后安装一个(使用npm或安装器,以所用为准),以及 `CONCORD_NO_UPDATE_CHECK=1` 禁用检查. ## 这是不是 共享工作状态和任务内存,用于使用相同的本地编码代理 结账. **没有** 一个管弦乐手,代码审查员,主机同步服务,内存 向量 DB, 或自动编码代理 . 另见: [为什么不用减价法呢?](https://npmcn.com/package/%40concord-ai/concord-mcp/docs/why-not-markdown.md) ## 捐款 见 [`CONTRIBUTING.md`](https://npmcn.com/package/%40concord-ai/concord-mcp/CONTRIBUTING.md) 财务报告和审定财务报表 [`CLAUDE.md`](https://npmcn.com/package/%40concord-ai/concord-mcp/CLAUDE.md)这个 repo 严格输入( 无) `any`,没有打字机)和模块化. 初等问题 标签 [`good first issue`](https://github.com/Get-Concord-AI/concord-mcp/labels/good%20first%20issue)。 。 。 . ## 恒星历史 [![Star History Chart](https://api.star-history.com/chart?repos=Get-Concord-AI/concord-mcp&type=date&legend=top-left&sealed_token=PLqZk9LDZSite53TJb5bwyYask4-B5wAFxLcp3Ki_mJ3KlMtSpH09lN3ohwJuoQNs5Kwg_0zPG2DEwcRzJZvCIP1Md6vMdHjNwF_WkjuX6gd44wkwWFzqrAWgXGx2bPFEuJFRhmuWUlbRLnPOw6uW7cVJzrlcxprXCDU3_hHmUlHaFjVjQulH7EkfyuA)](https://www.star-history.com/?repos=Get-Concord-AI%2Fconcord-mcp&type=date&legend=top-left) ## 隐私和遥测 Concord将产品和协调遥测发送给 `getconcord.ai`它包括: 随机安装/调用标识符;每个安装工作空间不可逆转 和任务流程假名; 协和/节点/平台版本; 规范客户端 元数据; 操作名称、结果和持续时间; 总计重叠/编辑保障 结果;信息发送阶段和延迟;任务生命周期过渡和 - 明确报告接受, 融合、人道干预和再造成果. Concord 从未发送代码、原始文件或寄存器路径、远程、用户名、原始 任务或代理标识符、消息标识符或内容、命令参数, 工具输入/输出,或任务内容。 接收服务器存储请求 IP 地址和生成/存储国家代码。 目前这些服务器侧字段 自动失效。 设定 `CONCORD_TELEMETRY_DISABLED=1` (或 `DO_NOT_TRACK=1`) 使遥测功能失效。 交付是最好的努力,永远不会 使协和操作失败. ## 许可证 [麻省理工学院](https://npmcn.com/package/%40concord-ai/concord-mcp/LICENSE) ## 常见问题 ### @concord-ai/concord-mcp 是什么？ 通过MCP为编码代理进行跨harness通信并共享工作状态\. ### 如何安装 @concord-ai/concord-mcp？ 在项目目录运行 npm install @concord-ai/concord-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 concord、concord-mcp，可以用 npx concord 直接运行。 ### @concord-ai/concord-mcp 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/concord-ai\_\_concord-mcp 是否存在。 ### @concord-ai/concord-mcp 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @concord-ai/concord-mcp 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.12。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @concord-ai/concord-mcp 可以商用吗？ @concord-ai/concord-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @concord-ai/concord-mcp 的下载量有多少？ 根据 npm 官方下载统计，@concord-ai/concord-mcp 在 2026/10/11 – 2026/11/09 这 30 天内被下载 3,987 次，日均约 133 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @concord-ai/concord-mcp 还在维护吗？ 最新版本 0\.21\.0 发布于 2026/11/09（1 天前）；至今共发布 33 个版本，其中过去 12 个月发布了 33 个；首次发布于 2026/07/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。