Openrouter Search MCP

OpenRouter搜索MCP服务器

一种模型上下文协议（MCP）服务器，使用OpenRouter的在线启用模型提供网络搜索功能。

特性

• 网页搜索：使用OpenRouter的在线模型搜索网络
• 可定制的模型：通过环境变量或每个请求参数配置要使用的OpenRouter模型
• 灵活的配置：支持全局和按请求选择模型

安装

1. 在MCP服务器目录中克隆或创建此服务器
2. 安装依赖项：

   npm install

1. 构建服务器：

   npm run build

配置

环境变量

• OPENROUTER_API_KEY （必需）：您的OpenRouter API密钥
• DEFAULT_MODEL （可选）：要使用的默认模型（默认为 openai/gpt-4o:online)

MCP设置

添加到MCP设置配置中：

{
  "mcpServers": {
    "openrouter-search": {
      "command": "node",
      "args": ["/path/to/openrouter-search/build/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here",
        "DEFAULT_MODEL": "openai/gpt-4o:online"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

web_search

使用OpenRouter的在线模型搜索网络。

参数：

• query （字符串，必填）：搜索查询
• model （字符串，可选）：用于此搜索的OpenRouter模型

例子：

{
  "query": "latest developments in AI",
  "model": "anthropic/claude-3-5-sonnet:online"
}

支持的型号

对于网络搜索功能，您可以使用任何OpenRouter型号 :online 后缀：

• openai/gpt-4o:online （默认）
• anthropic/claude-3-5-sonnet:online
• anthropic/claude-3-haiku:online
• google/gemini-pro:online
• openrouter/auto （使用web插件自动选择最佳模型）

运作原理：添加 :online 任何型号的slug都可以通过Exa支持的OpenRouter网络插件进行网络搜索。这相当于显式使用web插件。

替代：您也可以使用 openrouter/auto 其自动选择最佳模型并启用网络搜索。

使用示例

配置后，您可以通过MCP客户端使用搜索功能：

1. 基本搜索：“搜索有关量子计算的信息”
2. 特定型号搜索：使用 web_search 具有特定模型参数的工具
3. 基于环境：设置 DEFAULT_MODEL 全局更改默认模型

部署

此服务器可以作为web服务部署在Render.com、Heroku或Railway等平台上。

Render.com部署

1. 将此存储库分叉或克隆到您的GitHub帐户
2. 将您的GitHub存储库连接到Render.com
3. 使用以下设置创建新的Web服务：

- 生成命令: npm install && npm run build - 启动命令: npm start - 环境变量: - OPENROUTER_API_KEY：您的OpenRouter API密钥 - NODE_ENV: production （可选） - DEFAULT_MODEL：您喜欢的型号（可选）

服务器将自动检测部署环境并以web模式运行，同时提供文档界面和RESTneneneba API端点。

Web API终结点

当部署为web服务时：

• GET / -文档和状态页面
• GET /health -健康检查端点
• POST /search -Web搜索端点

API使用示例：

curl -X POST https://your-deployment-url.com/search \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI developments", "model": "openai/gpt-4o:online"}'

发展

要修改或扩展此服务器，请执行以下操作：

1. 编辑 src/index.ts
2. 跑 npm run build 编写
3. 重新启动MCP客户端以重新加载服务器

许可证

MIT许可证