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 許可證。