어떤 문제를 해결하나요?

여러 AI 에이전트(Claude Code, OpenClaw, WorkBuddy, 커스텀 에이전트 등)를 실행할 때, 이들은 각자 고립된 상태로 작동합니다. 다음과 같은 작업이 불가능합니다:

불안정한 웹훅이나 공유 데이터베이스 없이 서로 대화하기
에이전트 경계를 넘어 작업 스케줄링하기
일회성 프롬프트 이상의 컨텍스트 공유하기
과거 경험을 바탕으로 팀으로서 함께 진화하기

에이전트 통신 허브는 모든 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!')"

설정 파일이 필요 없습니다. 외부 서비스도 필요 없습니다. 로컬에서 작동합니다.

주요 기능 요약

카테고리	도구	기능
ID	6	에이전트 등록, 하트비트, RBAC 역할, 신뢰 점수
메시징	5	P2P / 브로드캐스트, FTS5 검색, 중복 제거
작업 스케줄링	8	7단계 상태 머신, 파이프라인, 병렬 그룹, 자동 재시도
메모리	5	개인 / 팀 / 전체 범위, 엣지 함수 점수 산정
오케스트레이션	11	의존성 체인(DFS 순환 감지), 품질 게이트, 핸드오버 프로토콜
진화	12	경험 공유, 4단계 전략 승인, 신뢰 점수 피드백 루프
보안	6	토큰 인증, 4단계 RBAC, 감사 해시 체인, CORS 화이트리스트
파일	3	업로드 / 다운로드 / 목록, 최대 10MB Base64

53개의 MCP 도구 · SQLite WAL (메시지 손실 제로) · SSE 푸시 지연 시간 50ms 미만

아키텍처

┌──────────────┐          ┌──────────────────────────┐          ┌──────────────┐
│   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)

Claude Code, OpenClaw, WorkBuddy, Hermes, 커스텀 에이전트 등 MCP 호환 에이전트라면 무엇이든 연결할 수 있습니다.

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

스킬로 사용

# ClawHub
clawhub install liuboacean/agent-comm-hub

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

MCP 설정

허브를 시작한 후, 에이전트의 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 에이전트 토큰, DB에 해시로 저장
감사 해시 체인	DB 트리거를 통한 `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 참조	모든 도구 시그니처 + 예제
오케스트레이션 가이드	파이프라인, 병렬 그룹, 품질 게이트
진화 엔진	신뢰 점수, 전략 승인 워크플로우
Hermes 통합	Hermes 에이전트 단계별 설정
README.md (영어)	이 페이지

라이선스

MIT — 개인 및 상업 프로젝트에서 자유롭게 사용하세요.

Agent-Comm-Hub