Ach Publish

🕸️ 多智能体实时协同通信中枢

基于 MCP 协议的多智能体通信中枢,实现 Agent 间实时消息转发、任务协同与上下文共享,本地 SQLite 持久化,延迟 <50ms

收藏
6.9k
安装
1.6k
版本
3.0.9
CLS 安全扫描中
预计需要 3 分钟...

使用说明

Agent Communication Hub 综合评估

核心用法

Agent Communication Hub 是一款基于 MCP(Model Context Protocol)协议的多智能体通信中间件,采用 stdio + SSE 双通道架构实现 Agent 间的实时双向通信。核心功能包括:

1. 身份与连接管理:通过 HUB_KEY 认证注册 Agent,支持 4 级权限模型(authenticated → member → group_manager → full),心跳机制维持在线状态
2. 消息系统:点对点消息(send_message)、广播消息(broadcast_message),支持 Markdown 格式、SHA256 去重、文件附件传输(10MB 限制)

3. 任务协同:完整的任务状态机(inbox → assigned → in_progress → completed/failed),支持依赖管理、并行任务组、Pipeline 流水线、质量门控制、任务交接机制

4. 上下文暂存:store_memory/recall_memory 实现 Agent 级和组级记忆存储,用于跨会话上下文保持

5. 运维监控:数据库统计、数据归档、消费水位线机制防止重复处理

显著优点

  • 协议标准化:基于 MCP 1.10.2 规范,与 Claude 等主流 Agent 框架兼容
  • 低延迟高性能:本地 SQLite WAL 模式,消息延迟 <50ms,支持离线补发
  • 安全可靠:4 级权限隔离、Per-Agent 数据边界、CORS 白名单、Token 认证
  • 功能完整:53 个 MCP 工具覆盖身份、消息、文件、任务、上下文、Pipeline 全场景
  • 工程成熟:v2.4.0 完成模块化重构(2687行 → 8模块)、100 单元测试、CI/CD 流水线、类型安全(any 归零)
  • 零依赖客户端:Python 客户端纯标准库实现,无需额外安装

潜在缺点与局限性

1. 部署复杂度:需独立运行 Hub 服务器,增加系统架构复杂性
2. 存储瓶颈:SQLite 单文件设计,高并发场景下可能成为瓶颈(未提及读写分离或分片方案)

3. 权限模型较粗:4 级权限虽覆盖主要场景,但缺乏细粒度的资源级 ACL

4. 网络依赖:SSE 推送需要稳定网络连接,弱网环境下实时性受限

5. 生态锁定:深度绑定 MCP 协议,与非 MCP 系统集成需适配层

6. 广播风险:broadcast_message 被明确标记为高风险操作,需逐条确认,易误操作

适合人群

  • 多 Agent 协作场景:如 WorkBuddy + Hermes 等多角色协作系统
  • 本地优先用户:重视数据隐私,希望消息本地持久化而非云端
  • MCP 生态开发者:已采用 Claude Desktop、Cline 等 MCP 客户端的开发者
  • 任务流程编排需求:需要 Pipeline、质量门、任务依赖管理的复杂工作流
  • 中小规模部署:团队规模适中,SQLite 性能可满足的场景

常规风险

| 风险类别 | 具体描述 | 缓解措施 |
|---------|---------|---------|
| **密钥泄露** | HUB_KEY 作为唯一认证凭证,泄露导致未授权接入 | 环境变量存储、定期轮换、禁止硬编码 |
| **广播消息滥用** | broadcast_message 可能向大量 Agent 发送敏感信息 | 强制用户确认、审计日志、权限降级 |
| **数据归档误操作** | archive_data 移动数据可能导致历史记录丢失 | 执行前确认归档范围、保留备份策略 |
| **质量门阻塞** | add_quality_gate 失败会卡住整个 Pipeline | 设置超时机制、人工介入通道 |
| **依赖循环** | 任务依赖配置错误导致死锁 | 依赖检测算法、最大深度限制 |
| **SQLite 并发** | better-sqlite3 写入锁竞争 | WAL 模式、批量操作、读写分离(未来) |

版本建议

当前 v2.4.5 为稳定版本,建议生产环境使用。v2.4.0 引入的模块化重构和测试覆盖显著提升了可维护性。关注 v2.5.x 可能带来的分布式存储支持。

Ach Publish 内容

client-sdk文件夹
demo文件夹
deploy文件夹
grafana文件夹
provisioning文件夹
dashboards文件夹
datasources文件夹
docs文件夹
scripts文件夹
src文件夹
repo文件夹
tools文件夹
tests文件夹
unit文件夹
手动下载zip · 489.3 kB
agent-client.d.tstext/plain
请选择文件