JinDaGe - openrouter-search-server MCP Details

article

README

🚀 OpenRouter 搜索 MCP 服务器

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

克隆仓库：将此仓库克隆到本地机器。

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

安装依赖项：
```
npm install
```
构建：编译 TypeScript 代码。
```
npm run build
```

📚 详细文档

配置指南

API 密钥：确保你拥有来自 OpenRouter 的 API 密钥。
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 许可证。

openrouter-search-server