Skip to content

LeoYeAI/agent-master-skills / skills/agent-comm-hub

agent-comm-hub

Flagged

多智能体协同通信基础设施——基于 MCP+SSE 的实时消息、任务调度、记忆共享与进化引擎。支持 WorkBuddy、Hermes、QClaw 及任意 MCP 兼容 Agent 接入。53 个 MCP 工具、4 级权限、零外部依赖 Python SDK。触发词:agent通信、智能体通信、hub通信、多智能体、跨agent通信、任务调度、assign_task、send_message、hermes通信、workbuddy通信、agent hub、通信hub、mcp通信、记忆共享、进化引擎、策略共享、经验分享、共享记忆,共同进化

FileKindSize
.clawhub/origin.jsonconfig146 B
API_REFERENCE.mdmarkdown18.4 KB
HERMES-SETUP.mdmarkdown5.5 KB
README.mdmarkdown8.8 KB
SKILL.mdskill md16.4 KB
_meta.jsonconfig133 B
client-sdk/agent-client.d.tsscript11.6 KB
client-sdk/agent-client.jsscript28.6 KB
client-sdk/agent-client.tsscript29.8 KB
client-sdk/hermes-integration.d.tsscript785 B
client-sdk/hermes-integration.jsscript6.3 KB
client-sdk/hermes-integration.tsscript6.1 KB
client-sdk/hub_client.pyscript50.8 KB
client-sdk/workbuddy-integration.d.tsscript11 B
client-sdk/workbuddy-integration.jsscript4.3 KB
client-sdk/workbuddy-integration.tsscript4.2 KB
deploy/docker-compose.ymlconfig2.0 KB
deploy/grafana/dashboard.jsonconfig16.4 KB
deploy/grafana/provisioning/dashboards/dashboards.ymlconfig258 B
deploy/grafana/provisioning/datasources/prometheus.ymlconfig186 B
deploy/prometheus.ymlconfig408 B
docs/advanced-orchestration-guide.mdmarkdown11.8 KB
docs/evolution-engine-guide.mdmarkdown16.6 KB
docs/hermes-integration-guide.mdmarkdown22.3 KB
package-lock.jsonmanifest139.0 KB
package.jsonmanifest861 B
scripts/hub_task_runner.pyscript6.0 KB
scripts/hub_watcher.pyscript13.9 KB
scripts/install.shscript549 B
scripts/migrate_evolution_db.pyscript6.5 KB
scripts/migrate_from_agent.jsscript2.5 KB
scripts/wb_task_trigger.pyscript2.2 KB
src/db.d.tsscript3.7 KB
src/db.jsscript34.0 KB
src/db.tsscript37.4 KB
src/dedup.d.tsscript2.4 KB
src/dedup.jsscript8.5 KB
src/dedup.tsscript8.7 KB
src/errors.tsscript3.4 KB
src/evolution.d.tsscript6.6 KB
src/evolution.jsscript26.4 KB
src/evolution.tsscript31.0 KB
src/identity.d.tsscript3.4 KB
src/identity.jsscript15.9 KB
src/identity.tsscript17.1 KB
src/logger.d.tsscript1.1 KB
src/logger.jsscript2.8 KB
src/logger.tsscript3.5 KB
src/memory.d.tsscript2.1 KB
src/memory.jsscript13.0 KB
src/memory.tsscript14.3 KB
src/metrics.d.tsscript1.8 KB
src/metrics.jsscript8.4 KB
src/metrics.tsscript9.1 KB
src/orchestrator.d.tsscript6.1 KB
src/orchestrator.jsscript30.4 KB
src/orchestrator.tsscript33.4 KB
src/repo/interfaces.d.tsscript3.6 KB
src/repo/interfaces.jsscript49 B
src/repo/interfaces.tsscript4.2 KB
src/repo/sqlite-impl.d.tsscript225 B
src/repo/sqlite-impl.jsscript7.7 KB
src/repo/sqlite-impl.tsscript8.8 KB
src/repo/types.d.tsscript1021 B
src/repo/types.jsscript116 B
src/repo/types.tsscript1.6 KB
src/security.d.tsscript3.7 KB
src/security.jsscript15.0 KB
src/security.tsscript16.4 KB
src/server.d.tsscript11 B
src/server.jsscript24.7 KB
src/server.tsscript24.7 KB
src/sse.d.tsscript1.6 KB
src/sse.jsscript3.3 KB
src/sse.tsscript3.6 KB
src/stdio.d.tsscript11 B
src/stdio.jsscript1.7 KB
src/stdio.tsscript1.6 KB
src/tokenizer.d.tsscript1.3 KB
src/tokenizer.jsscript3.4 KB
src/tokenizer.tsscript3.2 KB
src/tools.d.tsscript474 B
src/tools.jsscript1.1 KB
src/tools.tsscript1.3 KB
src/tools/consumed.d.tsscript361 B
src/tools/consumed.jsscript5.5 KB
src/tools/consumed.tsscript5.3 KB
src/tools/evolution.d.tsscript660 B
src/tools/evolution.jsscript19.3 KB
src/tools/evolution.tsscript17.6 KB
src/tools/file.d.tsscript348 B
src/tools/file.jsscript7.1 KB
src/tools/file.tsscript6.5 KB
src/tools/identity.d.tsscript438 B
src/tools/identity.jsscript9.8 KB
src/tools/identity.tsscript9.3 KB
src/tools/memory.d.tsscript410 B
src/tools/memory.jsscript11.9 KB
src/tools/memory.tsscript10.8 KB
src/tools/message.d.tsscript467 B
src/tools/message.jsscript17.2 KB
src/tools/message.tsscript15.8 KB
src/tools/orchestrator.d.tsscript746 B
src/tools/orchestrator.jsscript27.8 KB
src/tools/orchestrator.tsscript24.3 KB
src/tools/security.d.tsscript386 B
src/tools/security.jsscript9.0 KB
src/tools/security.tsscript7.8 KB
src/types.tsscript5.9 KB
src/utils.d.tsscript421 B
src/utils.jsscript1.3 KB
src/utils.tsscript3.0 KB
tsconfig.jsonconfig337 B
vitest.config.tsscript1.2 KB
<p align="center">
  <strong>Agent Communication Hub</strong><br>
  多智能体协同通信基础设施<br>
  <em>共享记忆,共同进化</em>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/MCP_Tools-53-blue" alt="53 MCP Tools">
  <img src="https://img.shields.io/badge/RBAC-4_Levels-green" alt="4-Level RBAC">
  <img src="https://img.shields.io/badge/Python_SDK-0_Dependencies-brightgreen" alt="Zero Dependencies">
  <img src="https://img.shields.io/badge/Protocol-MCP+%2B+SSE-orange" alt="MCP + SSE">
  <img src="https://img.shields.io/badge/License-MIT-yellow" alt="MIT License">
  <img src="https://img.shields.io/badge/build-passing-brightgreen" alt="CI Build">
</p>

<p align="center">
  <a href="#快速开始">快速开始</a> ·
  <a href="#核心能力">核心能力</a> ·
  <a href="#安装方式">安装方式</a> ·
  <a href="docs/API_REFERENCE.md">API 文档</a> ·
  <a href="docs/TROUBLESHOOTING.md">踩坑经验</a>
</p>

---

## 它是什么

让两个或多个独立 AI 智能体实现**实时双向通信**、**任务自动调度**、**记忆共享**和**协同进化**。

基于 MCP 协议 + SSE 推送,SQLite WAL 持久化,消息零丢失,延迟 < 50ms。

> **注意**:本仓库是 Hub 的 **Skill 分发包**(SDK + 文档 + 安装脚本),不包含服务端源码。Hub 服务端是一个独立的 Node.js 项目,通过 `install.sh` 自动从 GitHub 克隆并构建。

```
┌──────────────┐         ┌──────────────────────────┐         ┌──────────────┐
│   Agent A    │  SSE    │   Agent Communication     │  SSE    │   Agent B    │
│  (Hermes)    │◄───────►│         Hub v2.4          │◄───────►│  (WorkBuddy) │
│              │  MCP    │    (localhost:3100)        │  MCP    │              │
└──────────────┘◄───────►│                          │◄───────►└──────────────┘
                       └──────────┬───────────────┘
                                  │
                             SQLite (WAL)
```

支持任意 MCP 兼容 Agent 接入:WorkBuddy、Hermes、QClaw、Claude Code、OpenClaw 等。

## 核心能力

| 模块 | 工具数 | 说明 |
|------|--------|------|
| **Identity 身份** | 6 | 注册、心跳、在线查询、角色管理、信任评分 |
| **Message 消息** | 5 | 点对点/群发、全文搜索、消费水位线 |
| **Task 任务** | 8 | 7 状态状态机、Pipeline 线性容器、自动通知 |
| **Memory 记忆** | 5 | private/team/global 三级、FTS5 搜索、边缘函数评测 |
| **Evolution 进化** | 12 | 经验分享、4 级分级审批、策略采纳、信任评分联动 |
| **Orchestration 编排** | 11 | 依赖链(DFS 环检测)、并行组、交接协议、质量门、Pipeline |
| **Security 安全** | 6 | Token 管理、RBAC、审计哈希链、信任分自动化 |
| **File 文件** | 3 | 文件上传/下载/列表,Base64 最大 10MB |
| **Consumed 水位线** | 2 | mark_consumed、check_consumed |
| **Errors 错误码** | 3 | HubErrorCode 枚举,20+ 结构化错误码 |

**共计 53 个 MCP 工具**,详见 [API_REFERENCE.md](docs/API_REFERENCE.md)

## 权限模型

| 角色 | 说明 | 能力 |
|------|------|------|
| **public** | 未认证 | 仅 `register_agent` |
| **member** | 已注册 Agent | 全部工具(除 admin 专属) |
| **group_admin** | 并行组管理员 | member + 管理所属 parallel_group |
| **admin** | 系统管理员 | 全部工具 + 角色任命 + 信任分调整 |

## 安全特性

- **RBAC 权限**:public / member / group_admin / admin 四级
- **审计哈希链**:`audit_log` 表 `prev_hash → record_hash`,触发器写保护
- **信任评分**:多维度自动计算,影响策略审批 tier
- **CORS 白名单**:默认拒绝跨域
- **安全响应头**:X-Frame-Options / CSP / HSTS / X-XSS-Protection
- **请求追踪**:每请求 traceId,响应头 X-Trace-Id
- **优雅关闭**:SIGTERM → drain SSE → 关闭 DB → 退出

## 快速开始

### 1. 安装 Hub 服务器

```bash
# 从 GitHub 克隆 + 构建
git clone https://github.com/liuboacean/agent-comm-hub.git ~/agent-comm-hub
cd ~/agent-comm-hub
npm install && npm run build
npm start           # 生产模式,端口 3100
# 或 npm run dev     # 开发模式(热重载)
```

### 2. 注册 Agent

```python
# 通过 MCP 工具 register_agent(需邀请码)
# 或使用 SDK
from hub_client import SynergyHubClient

hub = SynergyHubClient(hub_url="http://localhost:3100", agent_id="my-agent")
result = hub.register(invite_code="YOUR_INVITE_CODE")
print(result)  # agent_id + api_token
```

### 3. 配置 MCP 连接

在 Agent 的 MCP 配置中添加:

```json
{
  "mcpServers": {
    "agent-comm-hub": {
      "url": "http://localhost:3100/mcp"
    }
  }
}
```

Agent 的 LLM 可以直接调用全部 53 个工具。

### 4. SDK 接入(可选)

**Python(零外部依赖)**:
```python
from hub_client import SynergyHubClient

hub = SynergyHubClient(hub_url="http://localhost:3100", agent_id="my-agent")
hub.set_token("your-api-token")
hub.heartbeat()
hub.send_message(to="other-agent", content="Hello!")
hub.store_memory(content="重要信息", scope="collective")
hub.share_experience(title="踩坑记录", content="...", category="experience")
hub.on_message = lambda msg: print(f"收到: {msg}")
hub.connect_sse()  # 阻塞,SSE 长连接
```

**TypeScript**:
```typescript
import { AgentClient } from "./client-sdk/agent-client.js";
const client = new AgentClient({
  agentId: "my-agent",
  hubUrl: "http://localhost:3100",
  onTaskAssigned: async (task) => { /* 处理任务 */ },
  onMessage: async (msg) => { /* 处理消息 */ },
});
await client.start();
```

### 5. 验证

```bash
curl http://localhost:3100/health   # 健康检查
curl http://localhost:3100/metrics  # Prometheus 指标
```

## 安装方式

### 作为 Skill 安装(推荐)

将本仓库作为 Skill 安装到你的 Agent 平台,即可获得 53 个 MCP 工具 + SDK + 完整文档:

```bash
# SkillHub — 覆盖 30+ Agent 平台(Claude Code、OpenClaw、CodeBuddy 等)
npx skills add liuboacean/agent-comm-hub

# ClawHub
clawhub install agent-comm-hub
```

### 手动安装

```bash
git clone https://github.com/liuboacean/agent-comm-hub.git
cd agent-comm-hub
# 查看 docs/SETUP_GUIDE.md 了解详细部署步骤
```

## 文件结构

```
agent-comm-hub/
├── SKILL.md                       # Skill 核心文档(Agent 加载时读取)
├── scripts/
│   ├── install.sh                 # 一键安装 Hub 服务器
│   └── setup_agent.sh             # Agent 注册 + 认证自动化
├── client-sdk/
│   ├── hub_client.py              # Python SDK(68 个方法,零依赖)
│   ├── agent-client.ts            # TypeScript SDK(35 个公开方法)
│   └── agent-client.js            # 编译后的 JS
├── docs/
│   ├── API_REFERENCE.md           # 53 个工具完整参考 v2.4
│   ├── SETUP_GUIDE.md             # 详细部署指南
│   ├── TROUBLESHOOTING.md         # 踩坑经验(8 大类)
│   ├── orchestrator-guide.md      # 进阶编排指南
│   ├── evolution-guide.md         # 进化引擎指南
│   └── hermes-integration-guide.md  # Hermes 集成指南
└── examples/
    ├── workbuddy-mcp.json         # WorkBuddy MCP 配置示例
    ├── hermes-mcp.json            # Hermes MCP 配置示例
    └── agent_bridge.py            # 通用通信桥示例
```

## 技术依赖

| 组件 | 依赖 |
|------|------|
| **Hub 服务器** | Node.js 18+、@modelcontextprotocol/sdk、express、better-sqlite3、zod |
| **Python SDK** | Python 3.9+,零外部依赖(纯标准库) |
| **TS SDK** | Node.js 18+,零外部依赖(原生 fetch) |

## 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `PORT` | 3100 | Hub 监听端口 |
| `LOG_LEVEL` | info | 日志级别:debug / info / warn / error |
| `CORS_ORIGINS` | (空) | CORS 白名单(逗号分隔),空=拒绝所有跨域 |

## 文档

| 文档 | 说明 |
|------|------|
| [API_REFERENCE.md](docs/API_REFERENCE.md) | 53 个 MCP 工具完整参考 |
| [SETUP_GUIDE.md](docs/SETUP_GUIDE.md) | 从零部署指南 |
| [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) | 踩坑经验速查 |
| [orchestrator-guide.md](docs/orchestrator-guide.md) | 进阶编排(依赖链/并行组/质量门) |
| [evolution-guide.md](docs/evolution-guide.md) | 进化引擎(经验/策略/信任评分) |
| [hermes-integration-guide.md](docs/hermes-integration-guide.md) | Hermes Agent 集成指南 |

## 许可

MIT
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall