mcpField
O
omni-mcp

omni-mcp

github.com/cheaper-inferenceAgent 工作流82.3k1.2k 次安装今天更新
代码仓库

关于 omni-mcp

omni-mcp 是用于连接 OmniRoute MCP 服务的技能，面向配置 MCP 客户端的用户。它说明三种传输方式，并涵盖路由、提供商管理、记忆、缓存、技能和审计工具。

主要功能

  1. 01支持 stdio、SSE 和 HTTP
  2. 02路由与提供商工具
  3. 03记忆与技能工具
  4. 04缓存与审计工具
  5. 0533 种权限范围

适用场景

  1. 01将 Claude Desktop 连接到 OmniRoute
  2. 02配置 Cursor 或 VS Code 连接
  3. 03按权限范围限制工具

MCP 相关

它通过 stdio、SSE 或 Streamable HTTP 将 MCP 客户端连接到 OmniRoute MCP 服务。该服务提供 110 个工具，分属 33 种权限范围。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cheaper-inference/omniroute --skill omni-mcp

安装后在 Claude Code 中输入/omni-mcp确认已加载。

详细介绍

概述

连接到 OmniRoute MCP 服务（110 个工具，3 种传输方式：SSE/stdio/HTTP）。涵盖路由、缓存、压缩、记忆、技能、提供商和审计工具，涉及 33 个权限范围。

身份验证

所有请求都需要有效的 Bearer 令牌或会话 Cookie。通过 POST /api/auth/login 获取令牌，或在本地开发时配置 REQUIRE_API_KEY=false。

端点

GET /api/mcp/audit

GET mcp › audit

curl http://localhost:20128/api/mcp/audit \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/mcp/audit/stats

GET mcp › audit › stats

curl http://localhost:20128/api/mcp/audit/stats \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/mcp/sse

GET mcp › sse

curl http://localhost:20128/api/mcp/sse \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/mcp/sse

POST mcp › sse

curl -X POST http://localhost:20128/api/mcp/sse \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/mcp/status

GET mcp › status

curl http://localhost:20128/api/mcp/status \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/mcp/stream

GET mcp › stream

curl http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/mcp/stream

POST mcp › stream

curl -X POST http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
DELETE /api/mcp/stream

DELETE mcp › stream

curl -X DELETE http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/mcp/tools

GET mcp › tools

curl http://localhost:20128/api/mcp/tools \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

负载

详细的请求/响应架构请参阅完整的 OpenAPI 规范：GET /api/openapi/spec 或 docs/openapi.yaml。

OmniRoute — MCP 服务

需要 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：

{
  "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-..." }
      }
    }
  }
}

核心工具示例（实时目录：110 个工具）

下表展示了具有代表性的核心工具；服务端的发现响应具有权威性，其中包含全部 110 个工具。

范围工具
healthomniroute_get_health
combosomniroute_list_combos, omniroute_get_combo_metrics, omniroute_switch_combo
routingomniroute_simulate_route, omniroute_best_combo_for_task, omniroute_explain_route
providersomniroute_get_provider_metrics, omniroute_check_quota, omniroute_route_request
budgetomniroute_set_budget_guard, omniroute_set_routing_strategy, omniroute_set_resilience_profile
testingomniroute_test_combo
memorymemory_add, memory_search, memory_delete
skillsskill_invoke, skill_list, skill_describe, skill_register
cacheomniroute_cache_stats, omniroute_cache_flush
adminomniroute_db_health_check, omniroute_sync_pricing, omniroute_get_session_snapshot

完整列表：GET $OMNIROUTE_URL/api/mcp/tools

范围

工具分为 33 个范围（仅聊天、只读记忆、完全管理员权限等）。 将范围名称作为 --scope 参数传递，或通过 X-Omniroute-Scope 标头传递。

参考

完整文档：https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/MCP-SERVER.md

评论

支持 Markdown