网页搜索服务

一个基于OpenRouter API的网页搜索服务,提供原始文本输出并与MCP客户端集成。

  • by joaomj
  • TypeScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 joaomj/openrouter-search-server

使用说明

注意力

已存档的仓库。关于未来的发展,请参见:https://github.com/joaomj/openrouter-websearch-mcp

OpenRouter搜索MCP服务器

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

特性

  • 通过OpenRouter进行网络搜索: 利用OpenRouter API执行web搜索。
  • 具体型号: 使用 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密钥: 请确保您拥有来自的API密钥 OpenRouter 的.

  2. MCP设置: 将以下配置块添加到MCP客户端的设置文件中(例如。, ~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 用于VS代码远程/代码空间或 ~/Library/Application Support/Claude/claude_desktop_config.json 适用于Claude桌面应用程序):

    {
      "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": []
        }
        // ... other servers
      }
    }
    
    • 替换 /home/<user>/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-preview-03-25 模型。

MCP工具调用示例:

<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。