SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场omni-mcp

omni-mcp

智能体与模型

查看项目

更新于 10-22 22:04

技能介绍

用途

OmniRoute MCP 服务器为支持 MCP（Model Context Protocol）的 AI 客户端提供接入 OmniRoute 能力的统一入口。通过它，客户端可以调用 OmniRoute 的模型路由、缓存、压缩、记忆、技能、提供商管理和审计等功能，共 110 个工具，分布在 33 个权限范围内。

主要能力

工具按领域分组，资料中给出的代表性范围包括：

  • health：健康检查工具 omniroute_get_health。
  • combos：组合的列出、指标查询与切换，如 omniroute_list_combos、omniroute_get_combo_metrics、omniroute_switch_combo。
  • routing：路由模拟、为任务推荐最佳组合、解释路由结果，如 omniroute_simulate_route、omniroute_best_combo_for_task、omniroute_explain_route。
  • providers：提供商指标、配额检查、请求路由，如 omniroute_get_provider_metrics、omniroute_check_quota、omniroute_route_request。
  • budget：预算防护、路由策略与弹性配置，如 omniroute_set_budget_guard、omniroute_set_routing_strategy、omniroute_set_resilience_profile。
  • testing：组合测试工具 omniroute_test_combo。
  • memory：记忆的增加、搜索与删除，如 memory_add、memory_search、memory_delete。
  • skills：技能的调用、列出、描述与注册，如 skill_invoke、skill_list、skill_describe、skill_register。
  • cache：缓存统计与清理，如 omniroute_cache_stats、omniroute_cache_flush。
  • admin：数据库健康检查、价格同步、会话快照等，如 omniroute_db_health_check、omniroute_sync_pricing、omniroute_get_session_snapshot。

完整的 110 个工具清单以服务器发现响应为准，也可通过 GET $OMNIROUTE_URL/api/mcp/tools 获取。

传输方式

服务器支持三种传输：

  • stdio：本地 IPC，适用于 Claude Desktop / VS Code 扩展。
  • SSE：GET $OMNIROUTE_URL/api/mcp/sse。
  • Streamable HTTP：POST $OMNIROUTE_URL/api/mcp/stream。

认证

所有请求都需要有效的 Bearer token 或会话 Cookie。令牌可通过 POST /api/auth/login 获取；本地开发时可配置 REQUIRE_API_KEY=false 关闭 API Key 校验。

使用方式

Claude Desktop：在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加：

{ "mcpServers": { "omniroute": { "command": "npx", "args": ["-y", "omniroute", "--mcp"], "env": { "OMNIROUTE_KEY": "sk-..." } } } }

Cursor / VS Code：

{ "mcp": { "servers": { "omniroute": { "url": "http://localhost:20128/api/mcp/sse", "headers": { "Authorization": "Bearer sk-..." } } } } }

访问需要设置 OMNIROUTE_URL 和 OMNIROUTE_KEY，具体初始化参见入口 SKILL 文档。权限范围可通过 --scope 参数或 X-Omniroute-Scope 请求头传入。

主要端点

  • GET /api/mcp/audit：审计信息。
  • GET /api/mcp/audit/stats：审计统计。
  • GET/POST /api/mcp/sse：SSE 传输。
  • GET /api/mcp/status：状态查询。
  • GET/POST/DELETE /api/mcp/stream：Streamable HTTP 传输。
  • GET /api/mcp/tools：工具列表。

请求与响应结构的完整定义可参考 GET /api/openapi/spec 或 docs/openapi.yaml。

适用场景

适合在支持 MCP 的桌面客户端或编辑器扩展中管理 OmniRoute 的模型组合与路由策略、查询提供商配额与指标、设置预算与弹性配置、进行组合测试，以及使用记忆和技能工具。

限制

资料未提供具体收费、价格、性能指标或工具完整清单；实际可用工具和权限以服务器返回为准。需注意认证要求，生产环境不应关闭 API Key 校验。