Nexus 是一个 Model Context Protocol（MCP）服务器，旨在通过 OpenRouter API 提供 AI 驱动的搜索功能。它可集成到支持 MCP 的客户端（如 Claude Desktop 和 Cursor）中，让用户在这些工具内直接使用多种 AI 模型进行搜索。
主要能力
Nexus 提供以下模型层级的搜索能力：
- sonar：快速问答，实时网络搜索，超时 30 秒，标准层级。
- sonar-pro：多步骤查询，实时网络搜索，超时 60 秒，高级层级。
- sonar-reasoning-pro：思维链推理，实时网络搜索，超时 120 秒，高级层级。
- sonar-deep-research：详尽研究报告，实时网络搜索，超时 300 秒，高级层级。
- grok-4：基于训练数据知识，无实时搜索，超时 60 秒，高级层级。
此外还具备：结构化引用提取、可配置的模型参数（temperature、max tokens、超时覆盖）、完整的错误处理与类型化错误类、带 TTL 的请求缓存、并发相同查询的请求去重、自动重试与指数退避、基于 Winston 的结构化日志、TypeScript 严格模式实现。
使用方式
零安装运行
可通过 bunx 或 npx 直接执行服务器，无需本地构建：
bunx nexus-mcp
或
npx nexus-mcp
服务器启动后通过 STDIO 传输监听 MCP 客户端连接。
环境要求
- Bun 1.0+（推荐）或 Node.js 18+
- OpenRouter API 密钥（在 openrouter.ai 注册获取）
与 MCP 客户端集成
在 Claude Desktop 的 ~/.claude/mcp_settings.json 中配置，或按照 Cursor 的 MCP 设置添加服务器配置：
- 参数：
["nexus-mcp"] - 环境变量：
OPENROUTER_API_KEY=your-api-key-here
通用 MCP 客户端连接参数：
- 传输方式：stdio
- 环境变量：
OPENROUTER_API_KEY=your-api-key-here
如未安装 Bun，可将配置中的 bunx 替换为 npx。配置更改后需重启客户端。
可用工具
主要的搜索工具提供 AI 搜索能力，参数包括：
- query（必填）：搜索查询，1-2000 字符。
- model（可选）：使用的模型，默认 sonar。可选值为上述五个模型。
- maxTokens（可选）：最大响应 token 数，1-4000，默认 1000。
- temperature（可选）：响应随机性，0-2，默认 0.3。
- timeout（可选）：覆盖默认超时，毫秒，5000-600000。
环境变量
OPENROUTER_API_KEY（必填）：OpenRouter API 密钥。NODE_ENV（可选）：环境设置（development、production、test）。LOG_LEVEL（可选）：日志级别（debug、info、warn、error）。
高级配置环境变量：
OPENROUTER_TIMEOUT_MS：请求超时毫秒数，默认 30000。OPENROUTER_MAX_RETRIES：最大重试次数，默认 3。OPENROUTER_BASE_URL：自定义 OpenRouter API 基础 URL。
服务器提供 config://status 资源，显示服务器健康状态、配置信息（API 密钥已掩码）、搜索工具可用性、运行时间与版本。
适用场景
Nexus 适合需要在 MCP 兼容客户端中快速获取带引用的实时网络搜索结果或基于训练数据知识的回答的开发者与用户。尤其适合希望避免复杂安装流程、直接在 Claude Desktop 或 Cursor 中调用 AI 搜索的场景。
限制与注意事项
- 需要 OpenRouter API 密钥，且 API 使用按 token 消耗计费（具体费率见 OpenRouter Models）。
- 高级模型（sonar-pro、sonar-reasoning-pro、sonar-deep-research、grok-4）属于高级层级，可能产生更高费用。
- 首次运行可能因下载包而启动较慢，后续运行会因缓存而加快。
- 若遇到速率限制，需等待重置（通常 1 分钟）或升级 OpenRouter 计划。
- 服务器要求 Bun 1.0+ 或 Node.js 18+ 运行时。
安装与开发
本地开发安装步骤：克隆仓库、安装依赖、构建服务器、配置 OpenRouter API 密钥、测试服务器。具体命令请参考仓库文档。
许可
MIT 许可证，详见 LICENSE 文件。
