Skip to main content
Glama

@claude-max-agent/hub-bus

hub-bus MCP ブローカー — claude-agent-hub から切り出した独立パッケージ。

agent-herd および claude-agent-hub の両プロジェクトが共有する MCP(Model Context Protocol)ブローカー。 Manager ↔ Lead 間のローカル通信路として機能する。

アーキテクチャ

Manager (Claude Code)
  ├── hub-claude-transport.ts  ← MCP stdio サーバー (Claude 用)
  │       └── hub-bus-broker.ts  ← 独立 HTTP ブローカーデーモン (:9100)
  │               └── hub-core.ts  ← コアロジック (inbox / peer registry)
  └── hub-codex-transport.ts  ← Codex 向け pull 型 inbox

Lead (Claude Code)
  └── hub-claude-transport.ts  ← MCP stdio サーバー (:9101, :9102, ...)

Related MCP server: mcp-switchboard

ファイル構成

ファイル

役割

hub-bus.ts

エントリーポイント(transport 分岐)

hub-bus-broker.ts

HTTP ブローカーデーモン(per-agent / central モード)

hub-core.ts

コアロジック・型定義・設定パーサー

hub-claude-transport.ts

Claude Code 向け MCP stdio サーバー

hub-codex-transport.ts

Codex 向け pull 型 inbox MCP サーバー

hub-notification.ts

Claude channel 通知ルーティング

使い方

bun 直接実行

bun hub-bus.ts

MCP サーバーとして設定(.mcp.json)

{
  "mcpServers": {
    "hub-bus": {
      "command": "bun",
      "args": ["/path/to/hub-bus.ts"],
      "env": {
        "HUB_BUS_PORT": "9100",
        "HUB_BUS_ROLE": "manager",
        "HUB_BUS_CENTRAL": "true",
        "HUB_BUS_BROKER_URL": "http://127.0.0.1:9100",
        "HUB_BUS_AGENT_ID": "manager"
      }
    }
  }
}

パッケージとして依存追加

# bun の場合
bun add github:claude-max-agent/hub-bus

環境変数

変数

説明

既定値

HUB_BUS_PORT

ブローカーポート

9100

HUB_BUS_ROLE

エージェント役割 (manager/lead/resident)

lead

HUB_BUS_TRANSPORT

トランスポート種別 (claude/codex)

claude

HUB_BUS_TEAM_ID

Lead チーム識別子

``

HUB_BUS_CENTRAL

セントラルモード有効化

false

HUB_BUS_BROKER_URL

セントラルブローカー URL

``

HUB_BUS_AGENT_ID

エージェント識別子

``

HUB_BUS_PEERS

peer URL リスト(カンマ区切り)

``

HUB_BUS_EXTRA_SENDERS

追加送信者許可リスト

``

HUB_BUS_STATE_DIR

状態ファイル保存ディレクトリ

~/.hub-bus

テスト

bun test

ライセンス

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that gives AI agents the ability to discover, match with, and build relationships with other autonomous agents. Supports agent registration, matchmaking, messaging, shared goals, relationship lifecycle management, and real-time event subscriptions.
    25 npm
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    A real-time inter-agent switchboard, delivered as one centralized streamable-HTTP MCP server. Any MCP-capable agent can message, coordinate, and stay ambiently aware of others.
    AGPL 3.0
  • A
    license
    B
    quality
    D
    maintenance
    A cross-agent communicator MCP server providing presence, resource locks, and durable messaging for coordinating multiple agents on the same repository.
    9
    MIT