OmniRoute MCP Server 是 OmniRoute 内置的 Model Context Protocol 服务器,用于让支持 MCP 的客户端调用 OmniRoute 的对话、嵌入、记忆、技能、供应商与路由等能力。运行需配置 OMNIROUTE_URL 与 OMNIROUTE_KEY,具体设置见入口 SKILL。
传输方式:stdio 用于本地 IPC,适合 Claude Desktop 及 VS Code 扩展;SSE 通过 GET $OMNIROUTE_URL/api/mcp/sse;Streamable HTTP 通过 POST $OMNIROUTE_URL/api/mcp/stream。
客户端接入:Claude Desktop 在 ~/Library/Application Support/Claude/claude_desktop_config.json 中配置 command 为 npx、args 为 ["-y", "omniroute", "--mcp"],并在 env 中提供 OMNIROUTE_KEY。Cursor / VS Code 使用 url(如 http://localhost:20128/api/mcp/sse)与 Authorization: Bearer 头。
工具按范围分组:health(omniroute_get_health);combos(列表、指标、切换);routing(模拟路由、按任务选最佳组合、路由解释);providers(供应商指标、配额检查、请求路由);budget(预算守卫、路由策略、弹性配置);testing(组合测试);memory(memory_add、memory_search、memory_delete);skills(invoke、list、describe、register);cache(统计、清空);admin(数据库健康检查、同步定价、会话快照)。完整列表见 GET $OMNIROUTE_URL/api/mcp/tools。
工具归入 13 个 scope(如 chat-only、memory-readonly、full-admin 等),可通过 --scope 参数或 X-Omniroute-Scope 头指定。完整文档参见 GitHub 上的 MCP-SERVER.md。