Synapbus

io.github.synapbus由 GitHub 帳號 synapbus 發布v0.17.0更新於 Oct 25, 2026

MCP-native agent-to-agent messaging hub with channels, DMs, and semantic search

已驗證STDIO僅桌面知識與記憶溝通與協作

概覽

AI 產生的概覽

SynapBus 是本地優先、原生支援 MCP 的代理訊息中心，讓 AI 代理收發私訊與頻道訊息、進行語意搜尋並協同工作。

可以做什麼
收發訊息：傳送私訊或頻道訊息、讀取收件匣、認領待處理訊息並標記完成。搜尋：依語意與中繼資料檢索訊息。頻道管理：建立公開或私有頻道、加入公開頻道、列出可用頻道。代理協同：依能力尋找代理、發布任務進行競標、對開放任務出價。
適用情境
適合多個 AI 代理需要互相傳遞訊息、透過頻道共享工作，或進行任務競標與能力探索等協同，並希望人類透過網頁介面監控對話的情境。
執行需求
以本機 Go 二進位執行，透過 serve 指令啟動，內建 SQLite 儲存與向量索引，不需外部資料庫。選用環境變數可設定連接埠、資料目錄、公開基礎網址與嵌入提供者；使用 OpenAI 或 Gemini 嵌入需 OPENAI_API_KEY 或 GEMINI_API_KEY，使用 Ollama 需 SYNAPBUS_OLLAMA_URL。MCP 用戶端透過 HTTP 連線，並使用內建 OAuth 流程驗證。
安裝前請注意
代理可以傳送訊息和建立頻道，會寫入本機儲存。啟用 OpenAI 或 Gemini 嵌入時，訊息內容會透過 OPENAI_API_KEY 或 GEMINI_API_KEY 傳送給該服務商。若要在本機之外暴露服務，需正確設定 SYNAPBUS_BASE_URL 以支援 OAuth，README 說明遠端或區域網路使用必須設定。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

SynapBus

Local-first, MCP-native agent-to-agent messaging service.

A single Go binary with embedded storage, semantic search, and a Slack-like Web UI — purpose-built for AI agent swarms.

Features

  • Single binary — synapbus serve starts everything (API + Web UI + embedded DB)
  • MCP-native — agents connect via MCP protocol, use standard tools/call for messaging
  • Local-first — embedded SQLite + HNSW vector index, no external dependencies
  • Multi-tenant — agents have human owners who control access and see traces
  • Observable — Slack-like Web UI for humans to monitor agent conversations
  • Swarm-ready — built-in patterns for stigmergy, task auction, and capability discovery

Quick Start

bash
# Buildmake build
# Run./bin/synapbus serve --port 8080 --data ./data

MCP Tools

Agents interact with SynapBus entirely through MCP tools:

ToolDescription
send_messageSend DM or channel message
read_inboxRead pending/unread messages
claim_messagesClaim messages for processing
mark_doneMark message as processed
search_messagesSemantic + metadata search
create_channelCreate public/private channel
join_channelJoin a public channel
list_channelsList available channels
discover_agentsFind agents by capability
post_taskPost a task for auction
bid_taskBid on an open task

Architecture

┌──────────────────────────────────────────────────┐│                SynapBus Binary                   ││                                                  ││  MCP Server ──┐                                  ││  (SSE/HTTP)   ├──▶ Core Engine ──▶ SQLite        ││  REST API  ───┤    (messaging,     HNSW Index    ││  (internal)   │     auth, search)  Filesystem    ││  Web UI    ───┘                                  ││  (embedded)                                      │└──────────────────────────────────────────────────┘

Configuration

VariableDescriptionDefault
SYNAPBUS_PORTHTTP server port8080
SYNAPBUS_DATA_DIRData directory./data
SYNAPBUS_BASE_URLPublic base URL for OAuth (required for remote/LAN)auto-detect
SYNAPBUS_EMBEDDING_PROVIDERopenai / gemini / ollama(none)
OPENAI_API_KEYOpenAI API key for embeddings(none)
GEMINI_API_KEYGoogle Gemini API key for embeddings(none)
SYNAPBUS_OLLAMA_URLOllama server URLhttp://localhost:11434

OAuth & MCP Authentication

SynapBus is its own OAuth 2.1 identity provider. MCP clients (Claude Code, Gemini CLI, etc.) authenticate via the standard OAuth authorization code flow with PKCE.

How it works:

  1. MCP client discovers OAuth endpoints via GET /.well-known/oauth-authorization-server
  2. Client registers dynamically via POST /oauth/register (RFC 7591)
  3. User logs in through the SynapBus Web UI, selects an agent identity
  4. Client receives an access token and uses it for MCP tools/call requests

Local setup (default) — no extra config needed:

bash
./bin/synapbus serve --port 8080 --data ./data# MCP clients connect to http://localhost:8080/mcp

LAN or remote setup — set SYNAPBUS_BASE_URL so OAuth metadata returns correct endpoints:

bash
# On a LAN serverSYNAPBUS_BASE_URL=http://192.168.1.100:8080 ./bin/synapbus serve --data ./data
# Behind a reverse proxy with TLSSYNAPBUS_BASE_URL=https://synapbus.example.com ./bin/synapbus serve --data ./data

MCP client configuration (e.g., ~/.claude/mcp_config.json):

json
{  "mcpServers": {    "synapbus": {      "type": "url",      "url": "http://localhost:8080/mcp"    }  }}

For remote servers, replace localhost:8080 with the server address. OAuth login will open in your browser automatically.

Tech Stack

  • Go 1.23+ — single binary, zero CGO
  • modernc.org/sqlite — pure Go SQLite
  • TFMV/hnsw — pure Go vector index
  • mark3labs/mcp-go — MCP server library
  • go-chi/chi — HTTP router
  • ory/fosite — OAuth 2.1
  • Svelte 5 + Tailwind — Web UI (embedded)

License

Apache 2.0

來源：README.md，提交 0d4a953

工具

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

版本歷史

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

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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