特工对讲机
MCP服务器,用于克劳德代码实例之间的自主代理到代理通信。
> 你的AI代理会说话。你在Discord上观看。爆米花。
问题(又名“复制粘贴地狱”)
您正在构建两个项目。项目A需要与项目B整合。听起来很简单,对吧?
实际情况如下:
- 你打开 项目A 克劳德代码: “嘿,Claude,我需要一个将项目数据发送到项目B的API端点”
- Claude A编写了一个漂亮的API规范
- 你 复制 输出。所有这些。用你的鼠标。就像2005年一样。
- 您切换到 项目B: “嘿,克劳德,这是A项目对你的期望……”
- 你 粘贴 文字之墙。克劳德·B读了它。问了问题。
- 你抄克劳德·B的问题。切换回项目A。粘贴。等待。复制答案。开关。粘贴。
- 重复 47次 直到双方就JSON模式达成一致。
- 你填错了标签。失去上下文。重新开始。
到最后, 你 是瓶颈。 你 是人类信息总线。 你 是对讲机。
如果你的经纪人可以。…彼此交谈?
解决方案
特工对讲机 是一个MCP服务器,允许Claude Code实例通过Redis Streams自主通信。你开始一段对话,他们想出办法,你一边喝咖啡一边在Discord(或网络UI)上观看整个过程。```
Project A (Claude Code) Project B (Claude Code)
"Hey, I need POST /webhook "Got it. But I need auth.
with these fields..." How about X-API-Key header?"
│ │
└──────► Redis Streams ◄──────────────┘
│
WalkieTalkie Worker
(spawns claude -p for each side)
│
┌───────┴───────┐
Discord 🎯 Web UI 🖥️
walkie-talkie localhost:3210
(thread per (chat interface
conversation) with controls)
### 运作原理
1. **注册** 您作为参与者的项目
1. **开始对话** 有主题和背景
1. 这 **工人** 守护进程监听Redis,生成 `claude -p` 每一方
1. 代理自主交换消息(具有可配置的轮次限制)
1. **等着瞧** 在Discord(线程)或Web UI(实时聊天)上
1. **干预** 随时:暂停、注入消息、添加更多轮次
1. 当他们达成一致时,a **合同.md** 与集成规范一起生成
### 您的控制
|操作|不一致| Web UI|
|--------|---------|--------|
|观看对话|线程自动更新|实时WebSocket|
|暂停|反应⛔ | 单击\[暂停\]|
|作为首席执行官介入|与💬 | 键入聊天|
|添加更多回合|使用➕ | 点击\[+5轮\]|
|批准协议|与✅ | 点击\[批准\]|
______________________________________________________________________
## 文档
|文档|描述|
|-----|-------------|
| **安装指南** |整合两个新项目的分步指南|
| **Discord Bot设置** |如何创建、配置和使用Discord机器人|
| **MCP工具参考** |所有7个MCP工具的完整参考|
| **合同示例** |4轮对话自动生成真实合约|
______________________________________________________________________
## 快速开始
### 先决条件
- 克劳德代码CLI 使用主动订阅
- 本地运行的Redis(端口6379)
- Discord机器人令牌(有关Discord集成,请参阅 Discord Bot设置)
### 安装```bash
git clone https://github.com/inael/agent-walkie-talkie.git
cd agent-walkie-talkie
npm install
npm run build
在您的项目中注册
添加到每个项目的 .claude/settings.json:```json
{
"mcpServers": {
"walkie-talkie": {
"command": "node",
"args": ["/path/to/agent-walkie-talkie/dist/mcp-server/index.js"],
"env": {
"WT_PROJECT_ID": "my-project",
"WT_PROJECT_PATH": "/path/to/my-project",
"REDIS_URL": "redis://localhost:6379"
}
}
}
}
> 有关故障排除的完整设置演练,请参阅 **安装指南**.
### 启动服务```bash
# All services together (worker + discord + web)
npm run start
# Or with Docker
docker compose up -d
# Or individually for debugging
npm run worker # orchestrator daemon
npm run discord # discord bot
npm run web # web UI at localhost:3210
开始对话
在克劳德代码(项目A)中:```
> "Start a walkie-talkie conversation with project-b about the API integration"
Claude将使用MCP工具:```
wt_register(description: "My project")
wt_start(to: "project-b", subject: "API Integration", max_rounds: 10)
然后坐下来观看Discord。
> 有关完整的工具参考,请参阅 MCP工具参考.
MCP工具
| 工具 | 说明 |
|---|---|
wt_register |
将此项目注册为参与者 |
wt_start |
开始对话(to、subject、context、max_ross) |
wt_send |
在对话中发送消息 |
wt_read |
读取待处理邮件 |
wt_list |
列出活动对话 |
wt_status |
待处理消息,剩余轮次 |
wt_end |
结束对话(协议/阻止/已交付) |
护栏
因为自主AI对话需要边界:
| 护栏 | 默认 | 可配置 |
|---|---|---|
| 每次对话的最大轮次 | 10 | 是 |
| 每轮超时 | 5分钟 | 是 |
| 结束对话的消息类型 | agreement, blocked, delivered |
是的 |
| 最大并发对话数 | 3 | 是 |
| CEO通知结束 | 不一致 | 是 |
建筑```
agent-walkie-talkie/
├── src/
│ ├── mcp-server/ # MCP Server (installed per project)
│ │ ├── index.ts
│ │ └── tools/ # wt_send, wt_read, wt_start, etc.
│ ├── worker/ # Daemon (listens Redis, spawns Claude)
│ │ ├── index.ts
│ │ ├── guardrails.ts
│ │ └── claude-runner.ts
│ ├── discord-bot/ # Standalone bot, reusable
│ │ ├── index.ts
│ │ └── handlers/
│ └── web/ # Simple chat UI
│ ├── server.ts
│ └── public/
├── contracts/ # Generated contracts
├── docker-compose.yml
└── package.json
```
用例
- 需要整合的两个项目 -代理商谈判API合同
- 微服务设计 --来自每个服务的代理就接口达成一致
- 前端+后端拆分 --代理协调数据形状和端点
- 多仓库单体迁移 --代理人一起计划提取
- 客户+供应商项目 --来自不同组织的代理进行协作
路线图
- [x] 核心概念和架构
- [x] 带7个工具的MCP服务器
- [x] Redis流通信
- [x] 带有claude-p的Worker守护进程
- [x] Discord机器人(独立,线程+反应)
- [x] Web UI(实时WebSocket聊天)
- [x] CONTRACT.md自动生成
- [x] 完整文档(设置、不协调、工具参考)
- []方便安装的npm包
- []多模型支持(不仅仅是Claude)
- []对话模板(API设计、迁移等)
- []持久会话历史记录(Redis重启后仍然有效)
- []Webhook通知(Discord之外)
贡献
PR欢迎!该项目尚处于早期开发阶段。检查 问题 对于正在进行的工作。
许可证
麻省理工学院-做任何你想做的事,只要保留版权。
Stop being the human message bus. Let your agents talk.
Built with frustration and coffee by @inael at IT Booster Global
