经 AI Skill Hub 精选评估,OmniRoute MCP工具 获评「强烈推荐」。已获得 4.9k 颗 GitHub Star,这款MCP工具在功能完整性、社区活跃度和易用性方面表现出色,AI 评分 8.2 分,适合有一定技术背景的用户使用。
OmniRoute MCP工具 是一款遵循 MCP(Model Context Protocol)标准协议的 AI 工具扩展。通过 MCP 协议,它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务,实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用,都可以通过自然语言在 AI 对话中直接触发,极大提升生产效率。
OmniRoute MCP工具 是一款遵循 MCP(Model Context Protocol)标准协议的 AI 工具扩展。通过 MCP 协议,它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务,实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用,都可以通过自然语言在 AI 对话中直接触发,极大提升生产效率。
# 方式一:通过 Claude Code CLI 一键安装
claude skill install https://github.com/diegosouzapw/OmniRoute
# 方式二:手动配置 claude_desktop_config.json
{
"mcpServers": {
"omniroute-mcp--": {
"command": "npx",
"args": ["-y", "omniroute"]
}
}
}
# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json
# 安装后在 Claude 对话中直接使用 # 示例: 用户: 请帮我用 OmniRoute MCP工具 执行以下任务... Claude: [自动调用 OmniRoute MCP工具 MCP 工具处理请求] # 查看可用工具列表 # 在 Claude 中输入:"列出所有可用的 MCP 工具"
// claude_desktop_config.json 配置示例
{
"mcpServers": {
"omniroute_mcp__": {
"command": "npx",
"args": ["-y", "omniroute"],
"env": {
// "API_KEY": "your-api-key-here"
}
}
}
}
// 保存后重启 Claude Desktop 生效
<img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="820"/>
<br/> <br/>
</div>
Recent highlights from v3.8.20 → v3.8.50. Full history in CHANGELOG.md.
/v1/models ordering — one contiguous provider-grouped block per provider (combos pinned first), stable across every catalog source. → API Referencesetup-* commands; omniroute run launches 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); omniroute configure supports 10 targets with an interactive provider+model picker and per-context favorites. → CLI Integrationsconnect / contexts / tokens) + an antigravity OAuth helper for VPS installs. → Remote Modeauto/<category>:<tier> combos, Fusion (model panel + judge), task-aware routing, per-request model / mode / USD-budget overrides. → Auto-ComboX-OmniRoute-* cost/usage headers on every endpoint, cache-HIT savings header, per-key USD spend quotas. → API Referencex-omniroute-no-memory. → Memory/v1/ocr (Mistral OCR) and /v1/audio/translations (Whisper-style) round out the media surface. → API ReferencebasePath, browser-language auto-detect, per-key device tracking, root-less MITM trust, zh-TW localization. → EnvironmentX-OmniRoute-Decision header naming the strategy/provider/latency that served it, a new cache-optimized combo strategy + Auto-Combo cacheAffinity factor route repeat requests back to the connection holding the cached prefix, and a read-only /v1/auto-combo/{channel}/candidates endpoint exposes an auto/* channel's live candidate pool. → Auto-Comboauto/chaos fault injection, a Telegram bot bridge, an in-app version manager and LMArena-ELO free-provider rankings. → Docs<br/>
</div>
<img src="./docs/diagrams/works-zero-config.svg" width="100%" alt="Works the second you install it — zero config. Three steps: 1. Install — npm i -g omniroute, server boots on localhost:20128. 2. Point your tool at http://localhost:20128/v1 — any OpenAI-compatible tool (Claude Code, Cursor, Cline). 3. It answers — call model auto for an instant reply, with no API key, no signup, no configuration. Keyless provider OpenCode Free is pre-wired into the auto combo, so a fresh install responds out of the box."/>
```bash
curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ```
<sub>Prefer a specific free backend? Call oc/… (OpenCode Free) directly. Then graduate to auto and let OmniRoute pick.</sub>
<sub>📦 Copy-paste quickstart scripts for Python, Node.js, PHP, and cURL → examples/quickstart/</sub>
<br/>
All 19 strategies — mix & match per combo step:
| # | Strategy | What it does |
|---|---|---|
| 1 | priority |
First-target ordered list — drain each before the next 🥇 |
| 2 | fill-first |
Fill each target's quota fully before moving on |
| 3 | weighted |
Weighted random by per-target weight |
| 4 | round-robin |
Cycle through targets in order |
| 5 | p2c |
Power-of-two-choices random load balancing |
| 6 | least-used |
Pick the target with the lowest current load |
| 7 | random |
Uniform random pick (deduplicated) |
| 8 | strict-random |
Random without de-duplicating repeats 🎲 |
| 9 | cost-optimized |
Minimize $ per request from live catalog pricing 💸 |
| 10 | headroom |
Pick the target with the most remaining quota |
| 11 | reset-window |
Prefer the target whose quota window resets soonest |
| 12 | reset-aware |
Rank by quota reset time — short windows first 📊 |
| 13 | context-relay |
Hand off context across targets for long conversations 🧠 |
| 14 | context-optimized |
Pick the best fit for the current context size |
| 15 | cache-optimized |
Pin each reusable prompt prefix to the same account — maximize prompt-cache hits 🎯 |
| 16 | lkgp |
Last-Known-Good Path — pins to the last successful provider, then falls back to rules |
| 17 | auto |
16-factor live scoring across every connection 🤖 |
| 18 | fusion |
Fan out to a panel of models + a judge synthesizes one answer 🧬 |
| 19 | pipeline |
Chain steps — each target's output feeds the next one 🔗 |
<sub>The Auto-Combo engine scores every candidate on 16 factors (health, quota, cost, latency, task fit, quality, session availability…) — see docs/routing/AUTO-COMBO.md.</sub>
##
No combo to create. Set your model to auto (or a variant) and OmniRoute builds a virtual combo from your connected providers, scored live:
| Model ID | What it optimizes for |
|---|---|
auto | 🎯 Balanced default (LKGP — sticks to your last good provider) |
auto/coding | 🧑💻 Quality-first weights for code generation |
auto/fast | ⚡ Lowest latency first |
auto/cheap | 💰 Cheapest per token first |
auto/offline | 🔋 Most quota / rate-limit headroom first |
auto/smart | 🔭 Quality-first + 10% exploration to discover better models |
auto/lkgp | 📌 Explicit last-known-good-provider stickiness |
auto/chaos | 🧪 Fault-injection weights for resilience testing (chaos engineering) |
##
omniroute configure codex # also: claude opencode qwen aider goose gemini cline continue kilo ```
Every command honors the active remote context (omniroute connect <host>), --dry-run previews the exact env/args without executing, and --api-key-env NAME keeps secrets out of your shell history. → CLI Integrations
<br/>
OpenAI |
Anthropic |
Gemini |
xAI Grok |
DeepSeek |
Mistral |
Qwen |
Meta Llama |
Groq |
NVIDIA |
MiniMax |
Cohere |
Perplexity |
HuggingFace |
Together |
Fireworks |
Cloudflare |
Baidu |
<sub>…and 330+ more — every icon resolves live from the dashboard's provider catalog. 📖 Provider Reference</sub>
<br/>
</div>
No new sidebar, no new chat UI — every model OmniRoute serves shows up right in the Copilot Chat model picker you already use. Since VS Code 1.122, provider models work without a GitHub sign-in or a Copilot subscription — agent mode, tool calling and vision, for free.
Install the OmniCopilot extension, point it at your OmniRoute server (defaults to localhost:20128), then open Copilot Chat → model picker → Manage Models… → OmniRoute.
| Store | Link | Works with |
|---|---|---|
| 🧩 VS Code Marketplace | Install → | VS Code — stable & Insiders |
| 🔓 Open VSX Registry | Install → | Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro… |
From inside the editor: open the Extensions view, search "OmniRoute", click Install — works the same way on both stores. Source, issues and the publishing runbook live at diegosouzapw/OmniCopilot.
<sub>📖 VS Code Copilot Chat guide — setup, what the picker shows, dashboard-in-a-tab, troubleshooting</sub>
<br/>
项目简介:OmniRoute是一个全新的路由解决方案,旨在帮助开发者高效地连接和管理各种AI工具和服务。
功能介绍:OmniRoute提供了多种功能,包括系统架构、数据流、内部机制、压缩指南等,帮助开发者深入了解其工作原理和优点。
安装步骤:OmniRoute支持多种安装方式,包括Docker、源码、pnpm和Arch Linux(AUR)等,帮助开发者轻松地部署和管理其服务。
使用教程:OmniRoute提供了详细的使用教程,包括安装和运行、连接免费提供商、指向编码工具等,帮助开发者快速上手和使用其服务。
配置说明:OmniRoute支持零配置,开发者可以简单地使用`auto`参数来创建一个虚拟组合,优化模型和服务的使用。
API/接口说明:OmniRoute提供了177个AI提供商的接口,支持多种API和协议,帮助开发者轻松地连接和管理其服务。
工作流/模块说明:OmniRoute的工作流包括客户端、OmniRoute压缩、提供商等,帮助开发者了解其内部机制和优点,包括压缩、组合和优化等
架构设计完善,多提供商支持能力强,token优化机制创新。代码质量高,社区活跃度好,生产可用性强。
AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一,可自由商用、修改、分发,仅需保留版权声明。
AI Skill Hub 点评:OmniRoute MCP工具 的核心功能完整,质量优秀。对于Claude Desktop / Claude Code 用户来说,这是一个值得纳入个人工具库的选择。建议先在非生产环境试用,再逐步推广。
| 原始名称 | OmniRoute |
| 原始描述 | 开源MCP工具:Never stop coding. Free AI gateway: one endpoint, 160+ providers, RTK+Caveman st。⭐4.9k · TypeScript |
| Topics | API网关模型代理多提供商token优化开源工具 |
| GitHub | https://github.com/diegosouzapw/OmniRoute |
| License | MIT |
| 语言 | TypeScript |
收录时间:2026-05-19 · 更新时间:2026-05-19 · License:MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。
选择 Agent 类型,复制安装指令后粘贴到对应客户端