核心定位
Agent Communication Hub(ACH)是一款面向多智能体协作的本地通信中间件,采用 MCP(Model Context Protocol)标准协议,通过 stdio/HTTP-SSE 双通道架构,让独立运行的 AI Agent 实现低延迟(<50ms)、高可靠的消息互通与上下文同步。
核心能力详解
三层协议架构:MCP 工具层(JSON-RPC)处理结构化操作,SSE 推送层负责实时事件通知,底层 SQLite WAL 保障数据持久化。56 个 MCP 工具覆盖完整协作生命周期:身份注册与心跳管理(6 个)、点对点/广播消息(5 个)、文件传输(3 个)、任务全生命周期管理(3 个)、上下文暂存与检索(5 个),以及任务协同(并行组、Pipeline、质量门、交接机制)、运维监控、消费水位线等高级功能。
任务状态机:从 inbox → assigned → in_progress → completed/failed/cancelled 的完整流转,支持依赖检查、质量门拦截、信任分动态计算。
安全加固亮点:v3.0.x 版本实现 fail-closed 权限矩阵(4 级角色:authenticated/member/group_manager/full),stdio 强制 HUB_AUTH_TOKEN 认证(缺失即退出),对象级归属校验(assertOwns 中间件),WORM 审计日志不可篡改,sender 身份守卫杜绝伪造,数据域隔离确保 Agent 仅可见自身消息。
显著优势
- 协议标准化:基于 MCP 开放协议,非私有方案,兼容 Claude、Cline 等 MCP 客户端
- 纯本地部署:SQLite + stdio 模式,数据不出境,满足敏感场景合规要求
- 零外部依赖:Python 客户端仅使用标准库,Node 服务端依赖成熟
- 实时双向:SSE 推送 + 离线补发机制,Agent 上下线无感知切换
- 生产级安全:v3.0 版本权限模型、审计、CORS、Token 管理全面加固
潜在局限
- 单点架构:当前版本为单机 SQLite,无分布式共识,高可用需自行搭建主备
- 容量上限:better-sqlite3 单机性能瓶颈,超百万级消息需分库或归档策略
- MCP 生态早期:工具生态不如 REST/gRPC 成熟,调试需理解 JSON-RPC + SSE 双通道
- 权限粒度较粗:4 级角色覆盖多数场景,但缺乏字段级权限控制
适合人群
- 本地多 Agent 协作场景(如 Coding Agent + Research Agent + Review Agent)
- 对数据隐私敏感、要求完全本地化的企业/个人开发者
- 已采用 MCP 协议栈、需统一 Agent 通信层的团队
- 需要任务编排、Pipeline、质量门等生产级工作流控制的用户
常规风险
- Token 泄露:HUB_AUTH_TOKEN 为唯一认证凭证,泄露后所有 Agent 可被冒充
- 广播误操作:broadcast_message 需逐条确认,防止消息风暴或敏感信息扩散
- Pipeline 阻塞:质量门配置不当会导致任务级联失败,需合理设置评估标准
- 数据归档风险:archive_data 操作不可逆,需确认归档范围
- SQLite 锁竞争:高并发写入场景可能出现 WAL 锁等待,需监控 db_stats