Ach Publish

🤝 多智能体实时通信与任务协同中枢

多智能体消息转发与上下文共享中间件,基于 MCP 协议实现 Agent 间实时通信、任务协同与上下文持久化,支持 56 个标准工具接口和 4 级权限管控。

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

使用说明

核心评估

Agent Communication Hub 是一款面向多智能体架构的通信中间件,旨在解决独立 AI Agent 之间的实时协作难题。基于 MCP(Model Context Protocol)协议构建,采用 stdio 模式运行,通过 SQLite 本地持久化实现低延迟(<50ms)的双向消息传递与上下文同步。

核心用法

Hub 提供 56 个标准化 MCP 工具,覆盖六大功能域:

  • 身份管理:Agent 注册、心跳保活、在线状态查询
  • 消息系统:点对点消息、广播(需确认)、消息确认与批量处理、全文搜索
  • 文件传输:Base64 附件传输(10MB 限制)
  • 任务协同:任务分配、状态流转(inbox→assigned→in_progress→completed/failed)、依赖管理、并行任务组、Pipeline 流水线
  • 上下文暂存:临时记忆存储与检索(creator 隔离保护)
  • 运维监控:数据库统计、数据归档

接入方式为标准 MCP stdio 服务器配置,Agent 通过 HUB_KEY 环境变量认证后,LLM 可直接调用 Hub 工具完成跨 Agent 协作。

显著优点

1. 协议标准化:基于 MCP 协议,与 Claude Desktop、Cline 等主流 MCP 客户端兼容
2. 低延迟架构:SSE 实时推送 + SQLite WAL 模式,端到端延迟控制在 50ms 以内

3. 完善的状态机:任务生命周期管理严谨,支持依赖检查、质量门控、任务交接等复杂流程

4. 数据隔离机制:Per-Agent 数据可见性控制,4 级权限模型(authenticated/member/group_manager/full)

5. 工程成熟度:159 个单元测试、ESM 完整迁移、统一错误码(HubError)、指数退避重试机制

6. 零依赖 Python 客户端:纯标准库实现,降低集成门槛

潜在局限与风险

1. 单点架构:Hub 作为中心化中间件,存在单点故障风险,无原生集群模式
2. 存储上限:SQLite 单文件架构,高并发场景下可能受限于文件锁和磁盘 I/O

3. 认证简化:仅依赖单一 HUB_KEY 环境变量,缺乏 OAuth 等现代认证协议支持

4. 网络假设:SSE 长连接依赖稳定网络,弱网环境下消息补发机制未详细说明

5. 权限粒度:4 级权限虽清晰,但缺乏动态 RBAC 或 ABAC 的细粒度控制能力

6. 经验记录黑盒share_experience 等策略管理功能描述不完整,依赖"特定权限配置"未公开

适合人群

  • 开发多 Agent 协作系统的工程师团队
  • 需要本地部署、数据不出境的企业场景
  • 已采用 MCP 生态、寻求标准化通信层的开发者
  • 原型验证阶段的 AI 工作流项目(架构简洁,集成快速)

安全考量

  • 密钥管理HUB_KEY 为单一共享密钥,泄露风险集中,建议配合密钥轮换机制
  • 输入校验:消息和任务均执行接收方校验(Agent 注册状态验证)
  • CORS 默认拒绝:跨域需显式配置白名单,降低浏览器端攻击面
  • 数据持久化:本地 SQLite 需关注文件权限配置(建议 600)

版本建议

当前 v3.0.12(文档中版本号存在 v2.5.1/v3.0.12 不一致,建议以 package.json 为准),Node 22 为推荐运行环境(better-sqlite3 原生模块 ABI 兼容性约束)。

Ach Publish 内容

dist文件夹
client-sdk文件夹
scripts文件夹
src文件夹
repo文件夹
tools文件夹
web文件夹
docs文件夹
src文件夹
repo文件夹
tools文件夹
web文件夹
手动下载zip · 333.6 kB
agent-client.d.tstext/plain
请选择文件