Kevinwatt MCP Server Searxng

🚀 SearXNG MCP サーバー

SearXNGに統合されたMCPサーバーの実装で、プライバシーに配慮したメタ検索機能を提供します。

✨ 主な機能

• メタ検索：複数の検索エンジンの結果を統合します。
• プライバシー重視：トラッキングやユーザープロファイリングを行いません。
• 多カテゴリ対応：一般、ニュース、科学、ファイル、画像、動画など様々なカテゴリをサポートします。
• 言語サポート：指定した言語またはすべての言語をサポートします。
• 時間範囲フィルター：日、週、月、年で検索結果を絞り込めます。
• 安全検索：3段階の安全検索フィルター（無、中、厳格）を提供します。
• 代替サポート：複数のSearXNGインスタンスにより信頼性を確保します。

📦 インストール

npm install -g @kevinwatt/mcp-server-searxng

💻 使用例

基本的な使用法

mcp-server-searxng

高度な使用法

Dive Desktop との連携

1. Dive Desktopで「+ MCPサーバーを追加」をクリックします。
2. 以下の設定をコピーして貼り付けます。

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ]
    }
  }
}

3. 「保存」をクリックしてMCPサーバーをインストールします。

📚 ドキュメント

web_search

• 複数のエンジンを使用したメタ検索を実行します。
• 入力:
  • query (文字列)：検索キーワード
  • page (数値、オプション)：ページ番号（デフォルト: 1）
  • language (文字列、オプション)：言語コード（例: 'en'、'all'、デフォルト: 'all'）
  • categories (配列、オプション)：検索カテゴリ（デフォルト: ['general']）
    • 利用可能な値: "general", "news", "science", "files", "images", "videos", "music", "social media", "it"
  • time_range (文字列、オプション)：時間フィルター（日/週/月/年）
  • safesearch (数値、オプション)：安全検索レベル（0: 無、1: 中、2: 厳格、デフォルト: 1）

🔧 開発

git clone https://github.com/kevinwatt/mcp-server-searxng.git
cd mcp-server-searxng
npm install
npm run build
npm start

📄 ライセンス

このMCPサーバーはMITライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。

前提条件

ローカルで実行されているSearXNGインスタンスが必要です。設定方法は以下の通りです。

🚀 クイックスタート

# 設定ディレクトリを作成
mkdir -p searxng

# 設定ファイルを作成
tee searxng/settings.yml << EOF
use_default_settings: true

server:
  bind_address: "0.0.0.0"
  secret_key: "CHANGE_THIS_TO_SOMETHING_SECURE"  # ランダムなキーを生成
  port: 8080

search:
  safe_search: 0
  formats:
    - html
    - json

engines:
  - name: google
    engine: google
    shortcut: g

  - name: duckduckgo
    engine: duckduckgo
    shortcut: d

  - name: bing
    engine: bing
    shortcut: b

server.limiter: false
EOF

# コンテナを起動
docker run -d \
  --name searxng \
  -p 8080:8080 \
  -v $(pwd)/searxng:/etc/searxng \
  searxng/searx:latest

設定ファイルの説明

• use_default_settings: true：デフォルト設定を使用し、追加の設定は不要です。
• bind_address: "0.0.0.0"：外部からのアクセスを許可します。
• secret_key：API認証に使用されるため、ランダムな文字列を設定してください。
• port: 8080：使用するポートを指定します。

環境変数

docker run -d \
  --name searxng \
  -p 8080:8080 \
  -e SEARXNG_BEANSTALKD=redis://beanstalkd:1327 \
  -v $(pwd)/searxng:/etc/searxng \
  searxng/searx:latest

複数インスタンスのサポート

MCPサーバーで複数のSearXNGインスタンスを設定するには、以下のようにします。

{
    "mcpServers": {
        "searxng": {
            "name": "searxng",
            "command": "npx",
            "args": [
                "-y",