🔍 Nexus MCP服务器
没有复杂性的AI集成
_无需安装即可实现智能AI模型搜索和发现_
______________________________________________________________________
Nexus是什么？
Nexus是一个 模型上下文协议（MCP）服务器 通过OpenRouter API提供AI驱动的搜索功能。它与MCP兼容的客户端集成，包括Claude Desktop和Cursor，通过多个型号系列提供搜索功能，包括Perplexity Sonar（实时网络搜索）和Grok 4（训练数据知识）。
关键特性
- 零安装部署：可通过以下方式执行
bunx（或npx)没有构建要求 - OpenRouter集成：多种人工智能模型，包括困惑声纳（网络搜索）和Grok 4（训练数据）
- MCP协议合规性：实施标准MCP工具和资源接口
- 生产架构：包括请求缓存、重复数据删除、重试逻辑和错误处理
- 类型安全实施：具有严格类型检查的完整TypeScript覆盖率
特性
部署
- 基于Bunx/NPX的执行，无需本地安装
- 跨平台兼容性（macOS、Linux、Windows）
- Bun 1.0+或Node.js 18+运行时要求
- 通过npm注册表自动更新版本
搜索功能
- 多个模型层次 具有不同的功能：
- sonar -快速问答，实时网络搜索（30秒超时，标准层） - sonar-pro -多步查询，实时网络搜索（60秒超时，高级级别） - sonar-reasoning-pro -思维链推理，实时网络搜索（120秒超时，高级级别） - sonar-deep-research -详尽的研究报告，实时网络搜索（300秒超时，高级级别） - grok-4 -训练数据知识，无需实时搜索（60秒超时，高级级别）
- 使用当前信息进行实时网络搜索（困惑模型）
- 训练数据知识反应（Grok 4）
- 从回复中提取结构化引文
- 可配置的模型参数（温度、最大令牌、超时覆盖）
建筑
- 使用类型化错误类进行全面的错误处理
- 使用可配置TTL请求缓存
- 请求对并发的相同查询进行重复数据删除
- 具有指数回退的自动重试逻辑
- 基于Winston的结构化日志记录
- 具有全类型覆盖的TypeScript严格模式实现
快速开始
先决条件
- 包子 1.0+（推荐）或Node.js 18+
- OpenRouter API密钥(在openrouter.ai注册)
快速安装
在不进行本地安装的情况下执行服务器：
# Set your OpenRouter API key
export OPENROUTER_API_KEY=your-api-key-here
# Run the server via bunx (recommended)
bunx nexus-mcp
# Or via npx
npx nexus-mcp服务器启动并通过STDIO传输监听MCP客户端连接。
测试安装
# Test the CLI help
bunx nexus-mcp --help
# Test the version
bunx nexus-mcp --version
# Run with your API key
OPENROUTER_API_KEY=your-key bunx nexus-mcp替代方案：当地开发设施
对于本地开发或定制：
- 克隆存储库：
git clone https://github.com/adawalli/nexus.git
cd nexus- 安装依赖项：
bun install- 构建服务器：
bun run build- 配置您的OpenRouter API密钥：
# Copy the example environment file
cp .env.example .env
# Edit .env and add your actual API key
# OPENROUTER_API_KEY=your-api-key-here- 测试服务器：
bun run start与MCP客户端集成
基于Bunx的集成（推荐）
配置MCP客户端以通过bunx执行服务器：
克劳德代码
配置在 ~/.claude/mcp_settings.json:
{
"mcpServers": {
"nexus": {
"command": "bunx",
"args": ["nexus-mcp"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here"
}
}
}
}配置更改后重新启动Claude Code。
光标
在Cursor的MCP设置中添加服务器配置：
- 名字:
nexus - 命令:
bunx - 参数:
["nexus-mcp"] - 环境变量:
OPENROUTER_API_KEY=your-api-key-here
配置更改后重新启动Cursor。
通用MCP客户端配置
标准MCP客户端连接参数：
- 运输标准： stdio
- 命令:
bunx - 参数:
["nexus-mcp"] - 环境:
OPENROUTER_API_KEY=your-api-key-here
替代方案：npx或本地安装
如果您没有安装Bun，请使用 npx 代替 bunx 在上述任何配置中。
对于本地安装（在遵循本地开发设置后）：
{
"mcpServers": {
"nexus": {
"command": "bun",
"args": ["run", "/path/to/nexus-mcp/dist/cli.js"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here"
}
}
}
}用法
集成后，您可以在MCP客户端中使用搜索工具：
基本搜索
Use the search tool to find information about "latest developments in AI"带参数的高级搜索
Search for "climate change solutions" using:
- Model: sonar-pro
- Max tokens: 2000
- Temperature: 0.3使用不同的模型
# Fast Q&A with real-time web search (default)
Search for "latest news" with model: sonar
# Deep research with comprehensive analysis
Search for "AI safety research" with model: sonar-deep-research
# Knowledge from training data (no web search)
Search for "explain quantum computing" with model: grok-4可用工具
search
提供人工智能搜索功能的主要搜索工具。
参数：
query（必填）：搜索查询（1-2000个字符）model（可选）：要使用的模型（默认值：sonar)
- sonar -实时网络搜索快速问答（30秒超时） - sonar-pro -带实时网络搜索的多步查询（60秒超时，高级） - sonar-reasoning-pro -实时网络搜索的思维链推理（120秒超时，溢价） - sonar-deep-research -具有实时网络搜索功能的详尽研究报告（300秒超时，高级） - grok-4 -训练数据知识，无需实时搜索（60秒超时，溢价）
maxTokens（可选）：最大响应令牌（1-4000，默认值：1000）temperature（可选）：响应随机性（0-2，默认值：0.3）timeout（可选）：覆盖默认超时时间（毫秒）（5000-6000000）
示例响应（困惑模型）：
Based on current information, here are the latest developments in AI...
[Detailed AI-generated response with current information]
---
**Search Metadata:**
- Model: perplexity/sonar
- Response time: 1250ms
- Tokens used: 850
- Timeout: 30000ms
- Search type: realtime
- Sources: 5 found示例响应（Grok 4模型）：
Quantum computing is a type of computation that harnesses quantum mechanics...
[Response based on training data knowledge]
---
**Search Metadata:**
- Model: x-ai/grok-4
- Response time: 3500ms
- Tokens used: 650
- Timeout: 60000ms
- Search type: training-data
- Cost tier: premium配置
环境变量
OPENROUTER_API_KEY（必需）：您的OpenRouter API密钥NODE_ENV（可选）：环境设置（开发、生产、测试）LOG_LEVEL（可选）：日志记录级别（调试、信息、警告、错误）
高级配置
服务器支持通过环境变量进行其他配置：
OPENROUTER_TIMEOUT_MS：请求超时（毫秒）（默认值：30000）OPENROUTER_MAX_RETRIES：最大重试次数（默认值：3）OPENROUTER_BASE_URL：自定义OpenRouter API基本URL
资源
服务器在以下位置提供配置状态资源 config://status 这表明：
- 服务器运行状况
- 配置信息（带屏蔽的API密钥）
- 搜索工具可用性
- 服务器正常运行时间和版本
故障排除
Bunx/NPX特定问题
“bunx:找不到命令”
- 安装Bun：
curl -fsSL https://bun.sh/install | bash - 或者，如果你安装了Node.js 18+，就回到npx
“npx:找不到命令”
- 确保已安装Node.js 18+：
node --version - 更新npm：
npm install -g npm@latest
“找不到包'nexus-mcp'”
- 该包可能尚未发布。改用本地安装
- 验证网络连接以访问npm注册表
首次运行时启动缓慢
- 在下载包的第一次运行时，这是正常的
- 由于缓存，后续运行将更快
- 为了更快地启动，请使用本地安装
npx出现“权限被拒绝”错误
- 尝试：
npx --yes nexus-mcp --stdio - 或者设置npm权限：
npm config set user 0 && npm config set unsafe-perm true
常见问题
“搜索功能不可用”
- 确保
OPENROUTER_API_KEY环境变量已设置 - 在验证您的API密钥是否有效 开放路由
- 检查服务器日志中的初始化错误
“身份验证失败：API密钥无效”
- 双重检查API密钥格式和有效性
- 确保密钥具有足够的信用/权限
- 直接在OpenRouter仪表板上测试密钥
“超出费率限制”
- 等待速率限制重置（通常为1分钟）
- 考虑升级您的OpenRouter计划以获得更高的限制
- 在OpenRouter仪表板中监控使用情况
连接超时
- 检查您的互联网连接
- 服务器将自动重试失败的请求
- 如果需要，增加超时时间：
OPENROUTER_TIMEOUT_MS=60000
MCP客户端无法连接到服务器
- 验证您的MCP配置是否使用了正确的命令和参数
- 检查您的MCP客户端环境中是否有Bun 1.0+或Node.js 18+可用
- 确保在环境变量中正确设置了API键
调试日志
通过以下方式启用调试日志记录：
对于当地发展： 添加 LOG_LEVEL=debug 到你的 .env 文件
对于MCP客户： 添加 LOG_LEVEL: "debug" 到 env MCP配置的一部分
这将提供以下详细信息：
- 配置加载
- API请求和响应
- 错误详细信息和堆栈跟踪
- 性能指标
测试连接
您可以通过检查MCP客户端中的配置状态资源或运行简单的搜索查询来测试服务器是否正常工作。
发展
对于在此服务器上工作的开发人员：
# Development with hot reload
bun run dev
# Run tests
bun run test
# Run tests with coverage
bun run test:coverage
# Lint code
bun run lint
# Format code
bun run formatAPI成本
OpenRouter根据令牌消耗对API使用进行收费：
- 定价：见当前费率 OpenRouter型号
- 监控：OpenRouter仪表板中提供使用情况跟踪
- 限制：在OpenRouter帐户设置中配置支出限制
- 优化：服务器实现响应缓存和请求重复数据消除，以最大限度地减少冗余的API调用
📚 文档
🤝 贡献
我们欢迎所有经验水平的开发人员的贡献！
🚀 开始使用
🐛 报告问题
💬 加入社区
🌟 认可
贡献者在我们的：
- 贡献者列表
- 重大贡献的发布说明
- 社区焦点和推荐
🔗 相关项目
📞 支持与社区
| 💬 需要帮助？ | 🔗 资源 |
|---|---|
| 快速问题 | |
| 错误报告 | |
| 文档 | OpenRouter文档 • MCP规范 |
| 功能请求 | 改进建议 |
📄 许可证
MIT许可证 -看 许可证 文件以获取详细信息。
______________________________________________________________________
由...制作❤️ 开源社区
• • 📚 阅读文档
_Nexus：没有复杂性的AI集成_