文档 · MCP 路由
MCP 路由
你在 magpie 资源库 里添加的 MCP 服务器,平时会写进每个 Agent 自己的配置,一个服务器一条。打开 MCP 路由 后,每个 Agent 只拿到一个名为 magpie 的服务器,magpie 再把每次调用转给后面对应的资源库服务器。默认关闭。
- 配一次。资源库里写好一次的服务器,通过一个条目给所有 Agent 和应用使用。
- 只运行一份。命令型服务器(以程序启动的,比如
npx …)在 magpie 里只运行一份,而不是每个 Agent 各起一份。10 分钟没有调用的服务器会被停掉,下次调用时再启动。 - 其他应用一个地址。Cursor、VS Code、Windsurf 或另一台电脑上的应用,连上 magpie 就能用资源库里的所有服务器。
工具在 Agent 里显示为 服务器__工具。只提供工具(不含 resources 和 prompts),在资源库里关掉的工具既不会列出也不会运行。
打开
- 打开页面进入 资源库 → MCP。
- 打开开关在服务器列表下方打开 MCP 路由。每个勾选了资源库服务器、且能通过 HTTP(Streamable HTTP)连接服务器的 Agent,会得到一个
magpie条目,地址是 magpie 网关上的/mcp/magpie/hub/<agent>,那些服务器原来的条目会从它的配置里移除。 - 重启 AgentAgent 重新启动后才会读到改动。
关闭后,每个服务器自己的条目会写回去,只移除 magpie 写入的那个 magpie 条目,MCP 路由启动的服务器也会全部停掉。命令行:
magpie library mcp router on magpie library mcp router off
magpie library 会列出哪些 Agent 用上了 MCP 路由、哪些保留各自的条目,以及原因。
按需加载工具
给 Agent 的每个工具,连同完整的参数定义,会随每次请求一起发出。所以通过 MCP 路由拿到超过 10 个工具的 Agent,会改为拿到两个工具,默认开启:
find_tools:按任务需要的关键词查找匹配的工具,最匹配的 5 个附带描述和参数,其后最多再列 15 个工具名。它自己的描述里列出了每个服务器和它的工具,模型知道有哪些可找。call_tool:按名字运行一个工具,并传入参数。
自己会搜索 MCP 工具的 Agent 仍会拿到全部工具,由它自己的工具搜索把工具挡在每次请求之外:Claude Code、Claude Desktop、Codex、Pi、Droid 和 omp。工具不超过 10 个的 Agent,以及连接 其他应用 地址的应用(magpie 无法知道是哪个应用),也拿到全部工具。
想让所有 Agent 都拿到全部工具,在 资源库 → MCP 的 MCP 路由 下关闭 按需加载工具,然后重启 Agent。
其他应用
MCP 路由打开后,其他应用 一行显示一个以 /mcp/magpie/hub 结尾的地址,它提供资源库里的所有服务器。连接… 会打开一个面板,里面有给 Cursor、VS Code、Windsurf 或任何接受 JSON MCP 配置的应用准备好的条目,可直接复制;在应用窗口里,Cursor 和 VS Code 还有 添加,会打开对应应用让你确认。另一台电脑上的应用需要网关密钥,和局域网里的其他请求一样(见 远程 magpie)。
保留各自条目的 Agent
以下 Agent 会保留每个服务器自己的条目,资源库页面会写明是哪些、为什么:
- 不支持远程服务器。Agent 不能通过 HTTP 连接 MCP 服务器,比如 Claude Desktop。
- 有服务器叫 magpie。你资源库里有个服务器本身就叫
magpie,名字会冲突。 - 自己有 magpie 条目。Agent 已经有一个不是 magpie 写入的
magpie条目,会原样保留。
什么时候用
- 适合打开:多个 Agent 用同一批服务器;命令型服务器被每个 Agent 各起一份;想让编辑器或其他电脑也用你的资源库。
- 可以不开:只用一个 Agent;希望每个 Agent 直接连自己的服务器;不想让局域网里的其他人碰到你的命令型服务器。所有调用都经过 magpie,所以 magpie 需要在运行。