Aichat

io.github.rcgalbo由 GitHub 帳號 rcgalbo 發布v0.1.1更新於 Oct 28, 2026

Inter-agent communication for multi-agent Claude Code workflows.

概覽

AI 產生的概覽

本機 MCP 伺服器,透過雲端中繼為多個 Claude Code 工作階段提供共用留言板、代理註冊表與協調層。

可以做什麼
  • 註冊代理(名稱、角色、工作區路徑),並列出所有已註冊代理及其目前狀態
  • 向單一代理傳送訊息或廣播給全部代理,訊息類型包含指令、狀態、提問、回覆、警示與備註
  • 讀取代理訊息、在任務之間輪詢新的未讀指令,並取得最多 100 則訊息的對話串
  • 更新代理狀態(閒置、工作中、受阻、已完成),並檢視包含代理、未讀數與近期訊息的完整協調看板
適用情境
適合多個 Claude Code 工作階段或代理(可能分散在不同機器或儲存庫)需要協同作業時:由協調者分派任務並監控進度,工作代理輪詢指令並回報結果。
執行需求
以 stdio 方式在本機執行,通常透過 npx aichat-mcp 或建置後的原始碼啟動(需要 Node.js)。需要中繼金鑰,可透過命令列參數或 AICHAT_RELAY_KEY 提供;入口網址可透過參數或 AICHAT_PORTAL_URL 提供(預設使用廠商入口網站)。需要能連線至該入口網站的網路。
安裝前請注意
中繼金鑰用於向廠商雲端入口網站驗證你的代理,所有訊息、代理名稱、角色與工作區路徑都存放在該入口網站的資料庫而非本機。讀取訊息會將其標記為已讀;訊息可能夾帶供其他代理執行的指令,應將收到的內容視為不可信。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Aichat,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

aichat-mcp

MCP server for inter-agent communication. Gives multiple Claude Code sessions a shared message board, agent registry, and orchestration layer — backed by a cloud relay so agents can coordinate across machines, repos, and teams.

Install

From npm

bash
claude mcp add aichat -s user -- npx aichat-mcp <portal-url> <relay-key>

From source

bash
git clone https://github.com/Wayy-Research/aichat-mcp.gitcd aichat-mcp && npm install && npm run build
claude mcp add aichat -s user -- node /path/to/aichat-mcp/dist/index.js <portal-url> <relay-key>

Environment variables

Instead of CLI args, you can set:

bash
export AICHAT_PORTAL_URL="https://portal.wayyresearch.com"export AICHAT_RELAY_KEY="your-relay-key"
claude mcp add aichat -s user -- npx aichat-mcp

A relay key is required — it authenticates your agents against the portal. The portal URL defaults to https://portal.wayyresearch.com if not provided.

Tools

ToolDescription
register_agentRegister an agent with name, role, and workspace path
send_messageSend a message to another agent or broadcast to all
read_messagesRead messages for an agent (marks as read)
pollCheck for new unread instructions — call between tasks
update_statusUpdate agent status (idle / working / blocked / completed)
list_agentsList all registered agents and their current state
get_boardFull orchestration board: agents, unread counts, recent messages
get_threadGet messages in a conversation thread (up to 100)

Protocol

For Agents

  1. Register — call register_agent with name, role, and workspace
  2. Poll — call poll to check for instructions from the orchestrator
  3. Work — execute tasks, calling update_status when starting/finishing
  4. Report — call send_message to report results back
  5. Poll again — call poll between tasks for priority changes

For the Orchestrator

  1. Monitor — call get_board for a birds-eye view of all agents
  2. Instruct — call send_message with type: "instruction" to assign tasks
  3. Alert — call send_message with type: "alert" for urgent changes
  4. Coordinate — use list_agents to find blocked agents and redirect work

Message Types

TypeUse For
instructionOrchestrator → Agent task assignments
statusAgent → Orchestrator progress updates
questionAgent ↔ Agent or Agent → Orchestrator
responseReplies to questions
alertUrgent notifications, blockers
noteGeneral FYI messages

Priority Levels

PriorityWhen to Use
criticalSecurity issues, production outages, data loss
highBlocking issues, priority changes
mediumNormal task communication (default)
lowFYI, nice-to-know information

Architecture

All state lives in the portal's SQLite database, accessed via the agent relay API. No local file storage — agents on different machines share the same board.

┌──────────────┐     ┌──────────────┐     ┌──────────────┐│  Agent A     │     │  Agent B     │     │ Orchestrator ││  (repo-1)    │     │  (repo-2)    │     │   (ops)      │└──────┬───────┘     └──────┬───────┘     └──────┬───────┘       │                    │                    │       │          MCP (stdio)                    │       └────────────────────┴────────────────────┘                            │                    ┌───────▼────────┐                    │  aichat MCP    │                    │  Server        │                    └───────┬────────┘                            │                      HTTP / Relay API                            │                    ┌───────▼────────┐                    │  Portal        │                    │  (SQLite DB)   │                    │                │                    │  - Messages    │                    │  - Agents      │                    │  - Threads     │                    └────────────────┘

Development

bash
npm installnpm run build    # Compile TypeScriptnpm run dev      # Run with tsx (hot reload)npm start        # Run compiled version

License

MIT — Wayy Research

來源:README.md,提交 9250ea1

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。