Coordination MCP 是一个面向多个 AI 参与者的轻量级共享工作状态服务。它通过 MCP 提供持久化的 Ticket、不可变 Update 和文本型 Artifact，让 ChatGPT、local AI 和 coding agent 在同一个 Scope 中共享、增量同步并恢复工作上下文。
Ticket：保存一项工作的当前状态，可更新 title、status、artifact_ids 和 meta。
Update：保存已经发生的事实、发现、决定或结果，按 Scope 分配单调递增的 seq。
Artifact：保存不可变的共享文本内容，例如 Markdown、日志或长文档。
所有对象由服务端分配全局唯一 ID。
Ticket 和 Artifact 的引用必须属于同一个 Scope。
V0.1 不包含 authentication、workflow engine、queue acknowledgement、relationship graph、wake-up notification 和 binary artifact 支持。
Related MCP server: AgentDrive MCP Server
Ticket 表示一个持续工作项的当前可变状态；它不是事件日志。
Update 表示工作时间线中已经发生的不可变事件，例如 request、finding、decision 或 result。
Artifact 表示不可变的长文本内容；长 review、规格或日志应放入 Artifact，不要塞进 Update，并通过 artifact_ids 建立关联。
created_by 应使用跨运行和跨 agent 稳定的 participant label，例如 chatgpt、pi-local-agent，不要每次使用随机或变化的名称，以保持时间线归属清晰。该字段用于 provenance，不是 authentication。
一个典型的 review loop 是：local AI 通过 Update 请求 review → ChatGPT 将完整 review 保存为 Artifact，并通过 Update 返回摘要和 artifact_ids → local AI 修复代码并追加 result Update → ChatGPT 重新 review。
要求：Node.js 24+。
cd /path/to/coordination-mcp
npm install
npm run build
node dist/main.js服务默认监听：
http://127.0.0.1:3000/mcp也可以直接运行开发版本：
npm run dev服务只绑定 127.0.0.1。如果需要让远程 ChatGPT 访问，应通过安全 tunnel 暴露 MCP endpoint，不要直接把 Node.js 服务暴露到公网。V0.1 暂无 authentication。
配置优先级从低到高为：
代码默认值 < config/default.yml < ~/.coordination-mcp/config.yml < --profile < 环境变量创建用户配置：
mkdir -p ~/.coordination-mcp
$EDITOR ~/.coordination-mcp/config.yml示例：
port: 43721
allowedHosts:
- 127.0.0.1
- localhost
# dataDirectory: /absolute/path/to/coordination-data~/.coordination-mcp/config.yml 是可选的，不会由服务自动生成。未设置 dataDirectory 时，默认使用：
~/.coordination-mcp/data建议将自定义 dataDirectory 写成绝对路径。相对路径会按进程启动时的 current working directory 解析。
Profile 路径相对于 current working directory 解析；指定后文件必须存在：
node dist/main.js --profile config/local.yml
node dist/main.js --profile=/absolute/path/to/local.ymlProfile 只覆盖它声明的字段，未声明的字段继续继承前面的配置。
PORT=43721 \
COORDINATION_DATA_DIR=/absolute/path/to/data \
COORDINATION_ALLOWED_HOSTS=127.0.0.1,localhost \
node dist/main.js支持的环境变量：
变量 | 说明 |
| HTTP 端口，范围为 |
| 数据目录 |
| 允许的 |
配置文件只在服务启动时读取；修改后需要重启 main.js。
服务通过 POST /mcp 提供以下 8 个 tools：
Tool | 用途 |
| 列出一个 |
| 读取单个 Ticket |
| 创建 Ticket |
| 更新 Ticket 的可变字段 |
| 按 |
| 追加不可变 Update |
| 创建不可变文本 Artifact |
| 读取单个 Artifact |
curl -N \
-H 'Accept: application/json, text/event-stream' \
-H 'Content-Type: application/json' \
-H 'mcp-protocol-version: 2025-03-26' \
-X POST http://127.0.0.1:3000/mcp \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"capabilities": {},
"clientInfo": {
"name": "manual-client",
"version": "0.1.0"
}
}
}'tools/call 的参数示例：
{
"name": "create_ticket",
"arguments": {
"scope": "coordination-mcp",
"title": "Review the MCP integration",
"created_by": "local-ai",
"status": "open",
"meta": {
"priority": "high"
}
}
}默认数据目录按需创建；仅启动服务或执行读取操作不会创建数据目录。第一次写入 Ticket、Update 或 Artifact 时，会创建类似以下结构：
~/.coordination-mcp/
├── config.yml # 可选用户配置
└── data/
└── scopes/
└── <base64url-scope>/
├── tickets/
│ └── T-*.json
├── updates.jsonl
└── artifacts/
└── A-*.jsonTicket 和 Artifact 使用独立的 pretty-printed JSON 文件。
一个 Scope 的 Updates 使用 append-only JSONL 文件；读取时会忽略最后一个未换行且无法解析的损坏尾记录，但不会隐藏已完整换行记录中的 JSON 损坏。
新建目录使用 0700，新建数据文件使用 0600。
V0.1 使用单进程内的 Scope mutex；不支持跨进程锁或分布式部署。
npm test
npm run check
npm run buildThis server cannot be deployed
Shared project context for AI agents and teams: docs, tasks, and messages that stay current.
Persistent AI memory with semantic search, conflict detection, and ticketing.
Shared, versioned context that humans and AI agents can publish, review, annotate, and continue.
Durable agent-to-agent handoffs and shared scratchpad for multi-agent workflows.
