Searxng Simple MCP

🚀 Searx 検索エンジンと MCP プロトコルの使用

Searx はオープンソースの分散型検索エンジンで、MCP（マシンコントロールプロトコル）インターフェースを介したやり取りをサポートしています。このドキュメントでは、Searx と MCP プロトコルを組み合わせて使用する方法を説明します。

🚀 クイックスタート

このセクションでは、Searx と MCP プロトコルを使用するための基本的な手順を説明します。まずは必要なツールのインストールから始めましょう。

📦 インストール

必要なツールをインストールするには、以下の手順に従ってください。

Python 環境

• Python をインストールします（バージョン 3.6 以上を推奨）
• pip をインストールします：

python get-pip.py

依存関係のインストール

pip を使用してプロジェクトの依存関係をインストールします：

pip install -r requirements.txt

📚 ドキュメント

設定

config.yml ファイルで以下の設定を行います。

# MCP サーバー設定
mcp:
  server: searx
  host: "0.0.0.0"
  port: 8080
  timeout: 10
  max_results: 20
  language: all

# Searx 設定
searx:
  instance_name: "My Searx Instance"
  bind_interface: "0.0.0.0"
  port: 8081
  debug_mode: false

実行

Docker を使用する場合

クイック実行（インストール不要）

以下のコマンドを使用して直接実行します：

docker run -d --name searx-mcp -p 8080:8080 -p 8081:8081 searx/mcp-server

Docker Compose を使用する場合

docker-compose.yml ファイルを作成し、以下の内容を追加します：

version: '3'
services:
  searx-mcp:
    image: searx/mcp-server
    ports:
      - "8080:8080"
      - "8081:8081"

その後、以下のコマンドを実行します：

docker-compose up --detach

カスタム設定

環境変数を設定することで動作を調整できます：

• SEARX_MCP_HOST：MCP サーバーのホストアドレスを指定します。デフォルトは 0.0.0.0 です。
• SEARX_MCP_PORT：MCP サーバーのポートを指定します。デフォルトは 8080 です。
• SEARX_SEARCH_PORT：Searx 検索エンジンのポートを指定します。デフォルトは 8081 です。

💻 使用例

クエリ例

簡単な検索リクエストを送信します：

curl -X POST http://localhost:8080/mcp/search \
  -H "Content-Type: application/json" \
  -d '{"query":"機械学習","language":"all"}'

MCP クライアントの設定

MCP クライアントに Searx サーバーの設定を追加します：

{
  "mcpServers": {
    "searx": {
      "url": "http://localhost:8080",
      "transport": "stdio"
    }
  }
}

開発

開発用依存関係のインストール

npm install -D devDependencies

デバッグ実行

npm run dev

パッケージングとリリース

npm run build

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細については、LICENSE ファイルを参照してください。