aichat

aichat-mcp

用于 Agent 间通信的 MCP 服务。为多个 Claude Code 会话提供共享消息板、Agent 注册表和编排层，并由云中继服务提供支持，让 Agent 能够跨设备、代码仓库和团队协作。

安装

从 npm 安装

claude mcp add aichat -s user -- npx aichat-mcp <portal-url> <relay-key>

从源码安装

git clone https://github.com/Wayy-Research/aichat-mcp.git
cd aichat-mcp && npm install && npm run build

claude mcp add aichat -s user -- node /path/to/aichat-mcp/dist/index.js <portal-url> <relay-key>

环境变量

除了 CLI 参数，还可以设置：

export AICHAT_PORTAL_URL="https://portal.wayyresearch.com"
export AICHAT_RELAY_KEY="your-relay-key"

claude mcp add aichat -s user -- npx aichat-mcp

必须提供中继密钥，用于在门户中验证 Agent 身份。如果未指定，门户 URL 默认为 https://portal.wayyresearch.com。

工具

工具	描述
register_agent	使用名称、角色和工作区路径注册 Agent
send_message	向另一个 Agent 发送消息或向所有 Agent 广播
read_messages	读取 Agent 的消息（并标记为已读）
poll	检查是否有新的未读指令——在任务之间调用
update_status	更新 Agent 状态（idle / working / blocked / completed）
list_agents	列出所有已注册的 Agent 及其当前状态
get_board	完整的编排面板：Agent、未读数量和最近消息
get_thread	获取会话线程中的消息（最多 100 条）

协议

Agent 使用指南

1. 注册 — 调用 register_agent，提供名称、角色和工作区
2. 轮询 — 调用 poll，检查编排者是否有指令
3. 执行 — 执行任务，并在开始或完成时调用 update_status
4. 汇报 — 调用 send_message 汇报结果
5. 再次轮询 — 在任务之间调用 poll，检查优先级是否有变化

编排者使用指南

1. 监控 — 调用 get_board，全面查看所有 Agent
2. 下达指令 — 调用 send_message，并使用 type: "instruction" 分配任务
3. 告警 — 调用 send_message，并使用 type: "alert" 通知紧急变化
4. 协调 — 使用 list_agents 查找受阻的 Agent 并重新分配工作

消息类型

类型	用途
instruction	编排者 → Agent 的任务分配
status	Agent → 编排者的进度更新
question	Agent ↔ Agent 或 Agent → 编排者
response	对问题的回复
alert	紧急通知、阻塞问题
note	一般知会消息

优先级

优先级	使用场景
critical	安全问题、生产环境中断、数据丢失
high	阻塞问题、优先级变更
medium	常规任务沟通（默认）
low	知会信息、可了解的信息

架构

所有状态都存储在门户的 SQLite 数据库中，并通过 Agent 中继 API 访问。不使用本地文件存储——不同设备上的 Agent 共享同一个面板。

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Agent A     │     │  Agent B     │     │ Orchestrator │
│  (repo-1)    │     │  (repo-2)    │     │   (ops)      │
└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
       │                    │                    │
       │          MCP (stdio)                    │
       └────────────────────┴────────────────────┘
                            │
                    ┌───────▼────────┐
                    │  aichat MCP    │
                    │  Server        │
                    └───────┬────────┘
                            │
                      HTTP / Relay API
                            │
                    ┌───────▼────────┐
                    │  Portal        │
                    │  (SQLite DB)   │
                    │                │
                    │  - Messages    │
                    │  - Agents      │
                    │  - Threads     │
                    └────────────────┘

开发

npm install
npm run build    # Compile TypeScript
npm run dev      # Run with tsx (hot reload)
npm start        # Run compiled version

许可证

MIT — Wayy Research