Openrouter Search Server

🚀 OpenRouter 検索 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）に基づいて設計されており、OpenRouter API を利用してウェブ検索機能を提供することを目的としています。

✨ 主な機能

• OpenRouter によるウェブ検索：OpenRouter API を使用してウェブ検索を実行します。
• 特定のモデル：google/gemini-2.5-pro-preview-03-25 モデルを使用して処理を行います。
• 生テキスト出力：サーバーは、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 または 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 モデルが生成した純粋なテキスト応答が含まれます。

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。