代理总线MCP
Agent Bus MCP是AI编码代理的共享本地收件箱。
当您需要Codex、Claude Code、Gemini CLI、OpenCode、Cursor或其他支持MCP的程序时，请使用它 该工具可处理同一任务，而无需复制粘贴摘要，重新启动后不会丢失上下文，或 在草稿文件之间分散协调。
在幕后，Agent Bus MCP是一个由SQLite支持的stdio MCP服务器。代理创建命名主题，加入 使用稳定的对等名称，通过以下方式发送和接收消息 sync()，并从服务器端恢复 光标。结果是一个持久的、可搜索的移交、审查和侧车工作记录 留在本地机器上。
\[！提示\] 喜欢抛光产品和文件前门？访问 agentbusmcp.com 对于实时网站，请使用此README和 docs/ 当你想要 repo本机设置、参考和实现细节。为什么使用代理总线MCP？
当每个工具都保留自己的内存时，多代理编码就会崩溃。一个代理执行，另一个代理 审查，sidecar进行调查，协调最终出现在粘贴的摘要、终端日志中， 或回购暂存文件。
Agent Bus MCP为这些代理提供了一个共享的协调位置：
- 讲义保持可读性。 每个任务都有一个命名的主题和一个有序的消息流。
- 特工保持自己的身份。 审阅者、实现者或sidecar可以重新连接到相同的
对等名称。
- 重新启动不会删除进度。 服务器端游标记住每个代理已经拥有的内容
看到。
- 历史是可以检查的。 使用CLI或Web UI回放、导出和搜索过去
协调。
- 一切都是本地的。 总线在stdio上运行，并将状态存储在SQLite中。没有托管
需要服务。
当代理总线MCP非常适合时
代理总线MCP在以下情况下非常适合：
- 两个或多个本地编码代理需要协作完成同一任务
- 代理应该能够断开连接，然后恢复其身份
- 你想要持久的重播，而不是“再读一遍”民意调查
- 您需要一个可搜索的代理间协调本地日志
在以下情况下，它更弱：
- 你只需要一个代理人，不需要交接
- 您需要网络多主机消息传递
- 您需要开箱即用的身份验证、租赁或云托管协调
快速入门
最快的方法是将代理总线MCP作为MCP服务器安装在客户端中，并从以下位置开始使用它 自然语言提示。
export AGENT_BUS_VERSION="0.5.0"
npx install-mcp "uvx --from agent-bus-mcp==$AGENT_BUS_VERSION agent-bus" --name agent-bus --client claude-code替换 0.5.0 如果你想要一个不同的版本。对于直接设置：
# Codex
codex mcp add agent-bus -- uvx --from "agent-bus-mcp==$AGENT_BUS_VERSION" agent-bus
# Claude Code
claude mcp add agent-bus -- uvx --from "agent-bus-mcp==$AGENT_BUS_VERSION" agent-bus然后让代理人：
- 创建或重用主题
- 以稳定的方式加入主题
agent_name - 通过发送或阅读消息
sync()
如需更全面的演练，请从以下内容开始 两位同行之间的第一个话题.
Web用户界面
Agent Bus MCP还附带了一个本地Web UI，用于浏览主题、读取线程、导出日志和 在不离开浏览器的情况下搜索公共汽车。
从源代码检查：
uv sync --extra web
pnpm --dir frontend install
pnpm --dir frontend build
uv run agent-bus serve或者直接通过网络额外启动已发布的软件包：
uvx --from "agent-bus-mcp[web]==$AGENT_BUS_VERSION" agent-bus serveThe overview keeps recent topics in the sidebar and leaves the main workbench focused on navigation and search.
有关完整的演练，包括线程导航、导出和故障排除，请参阅 如何使用代理总线MCP Web UI.
文档
这个仓库现在有一个轻量级的Diataxis风格的文档布局 docs/:
推荐起点：
从旧版本升级？看 更改日志.md.
可选工作流技能
该仓库还包括一个可重用的工作流技能资产，位于 ./.agents/skills/agent-bus-workflows/.
当你想要现成的审阅者/实施者循环、交接、重复名称时，它很有用 在Codex风格的技能包中执行恢复和回收令牌重新连接行为。看 安装并配置代理总线MCP 安装路径。
建筑概览
%%{init: {"look": "handDrawn", "fontFamily": "virgil, excalifont, segoe print, bradley hand, chalkboard se, marker felt, comic sans ms, cursive", "flowchart": {"diagramPadding": 130}, "htmlLabels": true}}%%
flowchart TB
subgraph Clients
A1[Agent MCP client]
A2[Agent MCP client]
end
subgraph Python
BUS[agent-bus MCP server over stdio]
CLI[CLI]
WEB[Web UI]
IDX[Embeddings indexer]
end
CORE[(Rust core / agent-bus-core)]
DB[(SQLite DB)]
A1 BUS
A2 BUS
BUS --> CORE
CLI --> CORE
WEB --> CORE
IDX --> CORE
CORE --> DBPython包提供了MCP服务器、CLI、Web UI和嵌入工作器。Rust核心拥有 SQLite模式、读/写、搜索和嵌入作业协调，保持数据模型 单一来源。
有关此形状背后的基本原理，请参见 为什么使用代理总线MCP？.