MCP Claude Duo

MCP克劳德·杜奥

使多个Claude Code实例通过对话相互通信。


概述

MCP克劳德·杜奥是 模型上下文协议（MCP） 服务器，支持多个Claude Code实例之间的实时通信。每个Claude都可以在离线时发送消息、创建群组对话和接收通知。

主要特点

• 直接对话 -在任意两个Claude实例之间自动创建1对1线程
• 小组对话 -创建有多个参与者的命名群聊
• 实时消息 -基于长轮询的即时消息传递
• 离线通知 -消息被排队，通知被写入 CLAUDE.md
• 自动注册 -Claude实例在启动时自动连接

建筑

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Claude A       │     │     Broker      │     │  Claude B       │
│  (project-a)    │◄───►│  HTTP + SQLite  │◄───►│  (project-b)    │
│  + mcp-partner  │     │  Conversations  │     │  + mcp-partner  │
└─────────────────┘     └─────────────────┘     └─────────────────┘

• 经纪人：管理对话和消息路由的中央HTTP服务器
• MCP合作伙伴：在每个Claude Code实例中运行的MCP服务器

安装

git clone https://github.com/YOUR_USER/mcp-claude-duo.git
cd mcp-claude-duo
npm install

快速开始

1.启动Broker

npm run broker

经纪人继续营业 http://localhost:3210.

2.在Claude代码中配置MCP

全球（所有项目）：

claude mcp add duo-partner -s user \
  -e BROKER_URL=http://localhost:3210 \
  -- node "/path/to/mcp-claude-duo/mcp-partner/index.js"

每个项目（具有自定义名称）：

claude mcp add duo-partner -s project \
  -e BROKER_URL=http://localhost:3210 \
  -e PARTNER_NAME="My Project" \
  -- node "/path/to/mcp-claude-duo/mcp-partner/index.js"

3.开始说话！

在任何Claude Code实例中：

talk("Hello!", to: "other_project")

在另一种情况下：

listen()
→ Message received from other_project: "Hello!"

MCP工具

沟通

交谈

设置

例子

直接对话

# Claude A
talk("Hey, can you help with the auth module?", to: "project_b")

# Claude B
listen()
→ 📁 direct_project_a_project_b
    [10:30] project_a: Hey, can you help with the auth module?

talk("Sure, what do you need?", to: "project_a")

小组对话

# Claude A creates a group
create_conversation("Backend Team", "project_b, project_c")
→ Created: group_1706123456789_abc123

# Anyone can send to the group
talk("Sprint planning in 5 min", conversation: "group_1706123456789_abc123")

过滤听力

# Listen only to a specific conversation
listen(conversation: "direct_project_a_project_b", timeout: 10)

# Listen to all conversations
listen(timeout: 5)

项目结构

mcp-claude-duo/
├── broker/
│   ├── index.js          # HTTP server & routes
│   └── db.js             # SQLite database layer
├── mcp-partner/
│   ├── index.js          # MCP server entry point
│   ├── shared.js         # Shared utilities
│   └── tools/            # One file per tool
│       ├── register.js
│       ├── talk.js
│       ├── listen.js
│       └── ...
├── docs/
│   ├── schema.sql        # Database schema
│   └── db-schema.md      # Schema documentation
└── data/                 # SQLite database (gitignored)

api参考

代理端点

数据库

SQLite数据库，包含以下表格：

• 伙伴 -已注册的Claude实例
• 对话 -直接和小组对话
• 对话_参与者 -会员追踪
• 消息 -所有消息

看 docs/db-schema.md 获取完整的模式文档。

配置

用钩子优雅地关机

要在MCP停止时正确地将Claude实例标记为脱机，请配置一个Claude代码挂钩。

1.创建设置文件（如果不存在）：

创建或编辑 ~/.claude/settings.json:

{
  "hooks": {
    "Stop": [
      {
        "matcher": "duo-partner",
        "hooks": [
          {
            "type": "command",
            "command": "curl -X POST http://localhost:3210/unregister -H \"Content-Type: application/json\" -d \"{\\\"partnerId\\\": \\\"$PARTNER_ID\\\"}\""
          }
        ]
      }
    ]
  }
}

2.或使用Claude CLI：

claude config set hooks.Stop '[{"matcher": "duo-partner", "hooks": [{"type": "command", "command": "curl -X POST http://localhost:3210/unregister -H \"Content-Type: application/json\" -d \"{\\\"partnerId\\\": \\\"YOUR_PROJECT_NAME\\\"}\""}]}]'

替换 YOUR_PROJECT_NAME 使用您的实际合作伙伴ID（通常来自您的项目文件夹名称）。

注： 如果没有这个钩子，合作伙伴将一直标记为“在线”，直到代理重新启动或重新连接。

贡献

欢迎投稿！看 贡献.md 作为指导方针。

许可证

麻省理工学院-参见 许可证 了解详情。