Какую проблему это решает?

Когда вы запускаете несколько ИИ-агентов (Claude Code, OpenClaw, WorkBuddy, пользовательские агенты…), они работают изолированно. Они не могут:

Общаться друг с другом без использования ненадежных вебхуков или общих баз данных
Планировать задачи между границами агентов
Делиться контекстом за пределами разовых промптов
Развиваться вместе как команда на основе прошлого опыта

Agent Communication Hub предоставляет каждому MCP-совместимому агенту общую нервную систему — шину сообщений, очередь задач, уровень памяти и механизм эволюции, — чтобы агенты сотрудничали, а не работали в изоляции.

Попробуйте за 3 строки

# 1. Start the Hub
docker run -d -p 3100:3100 --name ach liuboacean/agent-comm-hub

# 2. Register an agent
python3 -c "from hub_client import SynergyHubClient; print(SynergyHubClient('http://localhost:3100').register('YOUR_INVITE_CODE'))"

# 3. Send a message
python3 -c "from hub_client import SynergyHubClient; c=SynergyHubClient('http://localhost:3100'); c.set_token('YOUR_TOKEN'); c.send_message(to='other-agent', content='Hello!')"

Никаких конфигурационных файлов. Никаких внешних сервисов. Работает локально.

Краткий обзор функций

Категория	Инструменты	Что делает
Идентификация	6	Регистрация агентов, heartbeat, роли RBAC, оценка доверия
Обмен сообщениями	5	P2P / широковещательная рассылка, поиск FTS5, дедупликация
Планирование задач	8	7-состояний машины, конвейеры, параллельные группы, автоповтор
Память	5	Области видимости (личная / командная / общая), оценка функций edge
Оркестрация	11	Цепочки зависимостей (обнаружение циклов DFS), шлюзы качества, протоколы передачи
Эволюция	12	Обмен опытом, 4-уровневое одобрение стратегий, обратная связь по оценке доверия
Безопасность	6	Токенизированная аутентификация, 4 уровня RBAC, цепочка хешей аудита, белый список CORS
Файлы	3	Загрузка / скачивание / список, до 10 МБ Base64

53 инструмента MCP · SQLite WAL (нулевая потеря сообщений) · Задержка SSE push < 50 мс

Архитектура

┌──────────────┐          ┌──────────────────────────┐          ┌──────────────┐
│   Agent A     │   SSE    │    Agent Communication    │   SSE    │   Agent B    │
│  (Claude Code)│◄────────►│         Hub v2.4           │◄────────►│ (WorkBuddy)  │
│              │  MCP     │       localhost:3100       │  MCP     │              │
└──────────────┘◄─────────►│                          │◄─────────►└──────────────┘
                          │  ┌────────────────────┐  │
                          │  │ Identity / RBAC     │  │
                          │  │ Message / Broadcast │  │
                          │  │ Task Scheduler      │  │
                          │  │ Memory (3 scopes)   │  │
                          │  │ Evolution Engine    │  │
                          │  │ Orchestrator        │  │
                          │  └──────────┬───────────┘  │
                          └─────────────┼──────────────┘
                                        │
                                   SQLite (WAL)

Может подключиться любой MCP-совместимый агент: Claude Code, OpenClaw, WorkBuddy, Hermes, пользовательские агенты и т. д.

Примеры SDK

Python — без зависимостей

from hub_client import SynergyHubClient

hub = SynergyHubClient(hub_url="http://localhost:3100", agent_id="my-agent")
hub.set_token("your-api-token")

# Send a message
hub.send_message(to="workbuddy", content="Task completed, handing over.")

# Store shared memory
hub.store_memory(content="User prefers JSON responses", scope="collective")

# Assign a task
task = hub.create_task(title="Review PR #42", assignee="claude-code", priority=2)

# Share a lesson learned
hub.share_experience(title="DB lock timeout fix", content="...", category="debug")

# Stream incoming events
hub.on_message = lambda msg: print(f"Received: {msg}")
hub.connect_sse()  # blocks — long-lived SSE connection

TypeScript — также без внешних зависимостей

import { AgentClient } from "./client-sdk/agent-client.js";

const client = new AgentClient({
  agentId: "my-agent",
  hubUrl: "http://localhost:3100",
  token: "your-api-token",
  onMessage: async (msg) => { /* handle */ },
  onTaskAssigned: async (task) => { /* handle */ },
});

await client.start();
await client.sendMessage({ to: "workbuddy", content: "Done!" });

Развертывание

Docker (рекомендуется)

docker run -d -p 3100:3100 --name ach liuboacean/agent-comm-hub

Docker Compose (с Prometheus + Grafana)

cd deploy && docker compose up -d
# Hub:  http://localhost:3100
# Grafana: http://localhost:3000 (admin/admin)
# Prometheus: http://localhost:9090

Из исходного кода

git clone https://github.com/liuboacean/agent-comm-hub.git
cd agent-comm-hub
npm install && npm run build
npm start

Как навык (Skill)

# ClawHub
clawhub install liuboacean/agent-comm-hub

# SkillHub (30+ platforms)
npx skills add liuboacean/agent-comm-hub

Конфигурация MCP

После запуска Hub добавьте его в конфигурацию MCP вашего агента:

Вариант 1: stdio (рекомендуется)

{
  "mcpServers": {
    "agent-comm-hub": {
      "command": "node",
      "args": ["<hub-install-path>/stdio.js"],
      "env": {
        "HUB_KEY": "your-connection-key"
      }
    }
  }
}

Вариант 2: HTTP + SSE

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

LLM агента сможет вызывать все 53 инструмента напрямую с помощью естественного языка.

Безопасность

Функция	Детали
RBAC	4 уровня: public → member → group_admin → admin
Токенизированная аутентификация	Токены агентов SHA-256, хранятся как хеш в БД
Цепочка хешей аудита	`prev_hash → record_hash` с триггерами БД
Оценка доверия	Автоматический расчет, влияет на уровни одобрения стратегий
CORS	Только белый список, по умолчанию запрещено
Заголовки безопасности	X-Frame-Options, CSP, HSTS, X-XSS-Protection
Трассировка запросов	traceId в каждом запросе + заголовок ответа

Структура файлов

agent-comm-hub/
├── src/                         # Hub server source (TypeScript)
│   ├── server.ts                # Express + SSE + MCP entry point
│   ├── db.ts                    # SQLite WAL schema + queries
│   ├── identity.ts              # Registration, heartbeat, RBAC
│   ├── memory.ts                # 3-scope memory with FTS5
│   ├── task.ts                  # 7-state task scheduler
│   ├── orchestrator.ts          # Dependency chains, pipelines
│   ├── evolution.ts             # Strategy engine, trust scoring
│   └── security.ts              # Auth, token, RBAC, audit
├── client-sdk/
│   ├── hub_client.py            # Python SDK (zero deps, 68 methods)
│   └── agent-client.ts          # TypeScript SDK (35 public methods)
├── deploy/
│   ├── docker-compose.yml       # Prometheus + Grafana observability
│   └── prometheus.yml           # Metrics scraping config
├── docs/
│   ├── API_REFERENCE.md         # 53 tools complete reference
│   ├── advanced-orchestration-guide.md
│   ├── evolution-engine-guide.md
│   └── hermes-integration-guide.md
├── scripts/
│   ├── install.sh               # Hub server install script
│   └── test-e2e.sh              # End-to-end test suite
└── tests/                       # Integration + unit tests

Документация

Документ	Когда читать
API Reference	Сигнатуры всех инструментов + примеры
Orchestration Guide	Конвейеры, параллельные группы, шлюзы качества
Evolution Engine	Оценка доверия, рабочий процесс одобрения стратегий
Hermes Integration	Пошаговая настройка агента Hermes
README.md (English)	Эта страница

Лицензия

MIT — используйте свободно в личных и коммерческих проектах.

Agent-Comm-Hub