Openrouter Search Server

🚀 OpenRouter 搜索 MCP 服务器

这是一个基于模型上下文协议（MCP）设计的服务器，利用 OpenRouter API 提供网络搜索功能，为用户带来便捷的搜索体验。

🚀 快速开始

本服务器基于模型上下文协议（MCP）设计，借助 OpenRouter API 实现网络搜索功能。以下为你介绍快速开始的步骤。

✨ 主要特性

• 通过 OpenRouter 进行网络搜索：使用 OpenRouter API 来执行网络搜索操作。
• 特定模型：采用 google/gemini-2.5-pro-preview-03-25 模型进行处理。
• 原始文本输出：服务器返回 AI 模型直接生成的未经过解析的纯文本响应。
• MCP 集成：提供一个简单的 web_search 工具，与 MCP 客户端兼容。

📦 安装指南

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 或 Claude Desktop App）：

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

   • 将 /home/<user>/Cline/MCP/openrouter-search-server/build/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-preview-03-25 模型生成的纯文本响应。

💻 使用示例

基础用法

<use_mcp_tool>
<server_name>openrouter-search</server_name>
<tool_name>web_search</tool_name>
<arguments>
{
  \"query\": \"What is the latest version of the MCP SDK?\"
}
</arguments>
</use_mcp_tool>

📄 许可证

本项目采用 MIT 许可证。