OpenRouter 搜索 MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，旨在通过利用 OpenRouter API 提供网络搜索功能。

功能

• 通过 OpenRouter 进行网络搜索： 利用 OpenRouter API 执行网络搜索。
• 特定模型： 使用 google/gemini-2.5-pro-exp-03-25:free:online 模型。 :online 后缀启用该模型的网络搜索功能。
• 原始文本输出： 服务器返回 AI 模型生成的直接、未解析的文本响应。
• MCP 集成： 公开一个与 MCP 客户端兼容的简单 web_search 工具。

安装

1. 克隆： 将此存储库克隆到您的本地计算机。

   git clone https://github.com/joaomj/openrouter-search-server.git
   cd openrouter-search-server
   

2. 安装依赖项：

   npm install
   

3. 构建： 编译 TypeScript 代码。

   npm run build
   

配置

1. API 密钥： 确保您拥有来自 OpenRouter 的 API 密钥。

2. MCP 设置： 将以下配置块添加到您的 MCP 客户端的设置文件中（例如，VS Code Remote/Codespaces 的 ~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 或 Claude Desktop App 的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

   {
     "mcpServers": {
       "openrouter-search": {
         "command": "node",
         "args": [
           "/home/joao/Cline/MCP/openrouter-search-server/build/index.js"
         ],
         "env": {
           "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY_HERE"
         },
         "disabled": false,
         "autoApprove": []
       }
       // ... 其他服务器
     }
   }
   

   • 将 /home/joao/Cline/MCP/openrouter-search-server/build/index.js 替换为您系统上构建的 index.js 文件的实际绝对路径（如果您将其克隆到其他位置）。
   • 将 YOUR_OPENROUTER_API_KEY_HERE 替换为您实际的 OpenRouter API 密钥。

   重要提示： 服务器需要设置 OPENROUTER_API_KEY 环境变量。 永远不要将您的 API 密钥直接提交到代码或存储库中。

用法

一旦服务器配置并运行（可以通过在其目录中手动运行 npm start 或通过您的 MCP 客户端自动运行），您就可以使用 web_search 工具。

工具： web_search

服务器名称： openrouter-search（或您在 MCP 设置中使用的任何键）

输入：

• query (字符串，必需)：您要执行的搜索查询。

输出：

• 一个文本字符串，包含来自 OpenRouter API 的 google/gemini-2.5-pro-exp-03-25:free:online 模型的原始响应。

MCP 工具调用示例：

<use_mcp_tool>
<server_name>openrouter-search</server_name>
<tool_name>web_search</tool_name>
<arguments>
{
  \"query\": \"MCP SDK 的最新版本是什么？\"
}
</arguments>
</use_mcp_tool>

许可证

MIT。