mcpField
O
omni-mcp

omni-mcp

github.com/diegosouzapwAgent 工作流82.6k1.0k 次安装今天更新
代码仓库

关于 omni-mcp

omni-mcp 是连接 OmniRoute MCP 服务的 skill，可通过三种传输方式访问路由、提供方、缓存、记忆、技能和审计工具，并支持 33 个权限范围。

主要功能

  1. 01110 个工具，分属 33 个范围
  2. 02支持 SSE、stdio 和 HTTP
  3. 03路由与提供方工具
  4. 04缓存、记忆与技能工具
  5. 05审计和管理工具

适用场景

  1. 01将 MCP 客户端连接到 OmniRoute
  2. 02选择受限的工具权限范围
  3. 03管理路由与提供方操作
  4. 04检查缓存、记忆或审计数据

MCP 相关

通过 stdio、SSE 或 Streamable HTTP 将客户端连接到 OmniRoute MCP 服务。工具目录涵盖路由、提供方、缓存、记忆、技能、审计和管理。

安装

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

$npx skills add https://github.com/diegosouzapw/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