SearXNG MCP サーバー

AIアシスタントがプライバシーを尊重するメタ検索エンジンであるSearXNGを使用してウェブ検索を実行できるようにする、モデルコンテキストプロトコル（MCP）サーバーです。SearX.spaceからランダムなインスタンスを自動的に選択することで、追加のデプロイメントなしですぐに使用できます。また、基本認証によるプライベートインスタンスもサポートしています。

特徴

• ゼロ構成セットアップ: SearX.spaceからランダムなパブリックインスタンスを使用してすぐに動作します

• プライベートインスタンスのサポート: オプションの基本認証を使用して独自のSearXNGインスタンスに接続します

• カスタマイズ可能なパラメータを使用してウェブ検索を実行する

• 複数の検索エンジンのサポート

• プライバシー重視の検索結果

• Markdown形式の検索結果

• すべてのパラメータの適切なデフォルト値

注意 - パブリックインスタンスはこの目的では利用できない可能性があり、「ステータスコード429でリクエストが失敗しました」というメッセージが返されます。

Related MCP server: Exa MCP Server

インストール

前提条件

• Node.js (v16 以上)

• npm (v7以上)

• SearXNG インスタンスへのアクセス (セルフホストまたはパブリック)

ソースからインストール

# Clone the repository
git clone https://github.com/tisDDM/searxng-mcp.git
cd searxng-mcp

# Install dependencies
npm install

# Build the project
npm run build

構成

SearXNG MCP サーバーは、次の環境変数を使用して構成できます。

• SEARXNG_URL (オプション): SearXNGインスタンスのURL (例: https://searx.example.com )。指定しない場合は、 SearX.spaceからランダムにパブリックインスタンスが自動的に選択され、追加のデプロイメントなしでサーバーが使用可能になります。

• USE_RANDOM_INSTANCE （オプション）: URLが指定されていない場合にランダムインスタンスの選択を無効にするには、「false」に設定します。デフォルトは「true」です。

• SEARXNG_USERNAME (オプション): プライベートインスタンスに接続する際の基本認証のユーザー名

• SEARXNG_PASSWORD (オプション): プライベートインスタンスに接続する際の基本認証のパスワード

これらの環境変数は、プロジェクトのルート ディレクトリにある.envファイルで設定できます。

SEARXNG_URL=https://searx.example.com
SEARXNG_USERNAME=your_username
SEARXNG_PASSWORD=your_password

使用法

サーバーの実行

# If installed globally
searxngmcp

# If installed from source
node build/index.js

Claude Desktopとの統合

1. クロードデスクトップを開く

2. 設定 > MCPサーバーへ移動

3. 次の構成で新しい MCP サーバーを追加します。

   {
     "mcpServers": {
       "searxngmcp": {
         "command": "searxngmcp",
         "env": {
           // Optional: If not provided, a random public instance will be used
           "SEARXNG_URL": "https://searx.example.com",
           // Optional: Only needed for private instances with authentication
           "SEARXNG_USERNAME": "your_username",
           "SEARXNG_PASSWORD": "your_password"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }

VSCodeでClaudeと統合する

1. VSCodeを開く

2. 設定 > 拡張機能 > Claude > MCP設定に移動します

3. 次の構成で新しい MCP サーバーを追加します。

   {
     "mcpServers": {
       "searxngmcp": {
         "command": "node",
         "args": ["/path/to/searxng-mcp/build/index.js"],
         "env": {
           // Optional: If not provided, a random public instance will be used
           "SEARXNG_URL": "https://searx.example.com",
           // Optional: Only needed for private instances with authentication
           "SEARXNG_USERNAME": "your_username",
           "SEARXNG_PASSWORD": "your_password"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }

スモラジェントとの使用

SearXNG MCPは、AIエージェント構築用の軽量フレームワークであるSmolagentsと簡単に統合できます。これにより、Webを検索して結果を処理できる強力なリサーチエージェントを作成できます。

from smolagents import CodeAgent, LiteLLMModel, ToolCollection
from mcp import StdioServerParameters

# Configure the SearXNG MCP server
server_parameters = StdioServerParameters(
    command="node",
    args=["path/to/searxng-mcp/build/index.js"],
    env={
        "SEARXNG_URL": "https://your-searxng-instance.com",
        "SEARXNG_USERNAME": "your_username",  # Optional
        "SEARXNG_PASSWORD": "your_password"   # Optional
    }
)

# Create a tool collection from the MCP server
with ToolCollection.from_mcp(server_parameters) as tool_collection:
    # Initialize your LLM model
    model = LiteLLMModel(
        model_id="your-model-id",
        api_key="your-api-key",
        temperature=0.7
    )
    
    # Create an agent with the search tools
    search_agent = CodeAgent(
        name="search_agent",
        tools=tool_collection.tools,
        model=model
    )
    
    # Run the agent with a search prompt
    result = search_agent.run(
        "Perform a search about: 'climate change solutions' and summarize the top 5 results."
    )
    
    print(result)

利用可能なツール

検索検索

プライバシーを尊重するメタ検索エンジンSearXNGを使用してWeb検索を実行します。カスタマイズ可能なパラメータを使用して、関連するWebコンテンツを返します。

パラメータ

例

// Example request
const result = await client.callTool('searxngsearch', {
  query: 'climate change solutions',
  language: 'en',
  time_range: 'year',
  categories: ['general', 'news'],
  safesearch: 1,
  max_results: 5
});

発達

設定

# Clone the repository
git clone https://github.com/tisDDM/searxng-mcp.git
cd searxng-mcp

# Install dependencies
npm install

建てる

npm run build

ウォッチモード（開発用）

npm run watch

MCP Inspectorによるテスト

npm run inspector

ライセンス

マサチューセッツ工科大学