Skip to main content
Glama
SearXNG-MCP

SearXNG-MCP

by muzihuaner

SearXNG MCP Server

FastMCP に基づいて実装された SearXNG 検索 MCP サービスで、Streamable HTTP トランスポートを使用し、ローカル実行と Docker デプロイをサポートします。

SearXNG関連リンク:

公式ドキュメント:https://docs.searxng.org/

オンライン例:https://searx.space/

機能

  • MCP ツール search(query) を公開: キーワードに基づいて SearXNG インスタンスを呼び出し、検索結果の要約を返します。

  • HTTP エンドポイント http://<host>:<port>/mcp を介して MCP サービスを提供し、リモート/クロスドメイン呼び出しを容易にします。

  • ステートレス(stateless) Streamable HTTP モードを採用し、クライアントは Mcp-Session-Id を維持する必要がなく、直接並行呼び出しが可能です。

  • 環境変数による SearXNG インスタンスアドレスのカスタマイズをサポートし、プライベートデプロイに便利です。

Related MCP server: web-search-mcp

環境変数

変数名

デフォルト値

説明

SEARXNG_URL

https://searxng.abc.com

SearXNG インスタンスのルートアドレス(JSONを有効にする必要あり)

HOST

0.0.0.0

サービスがリッスンするアドレス

PORT

9000

サービスがリッスンするポート

ローカル実行

# 安装依赖(建议使用虚拟环境)
pip install -r requirements.txt

# 可选:自定义 SearXNG 实例(只需填根地址)
export SEARXNG_URL="https://your-searxng-instance"

# 启动服务
python Server.py

起動後、MCP エンドポイントは次のとおりです:

http://localhost:9000/mcp

Docker デプロイ

イメージのビルド

docker build -t searxng-mcp .

コンテナの実行

docker run -d \
  --name searxng-mcp \
  -p 9000:9000 \
  -e SEARXNG_URL="https://searxng.abc.com" \
  searxng-mcp

ポートを変更する場合は、コンテナ内外のポートと PORT を同時に上書きできます:

docker run -d \
  --name searxng-mcp \
  -p 8080:8080 \
  -e PORT=8080 \
  searxng-mcp

オンラインイメージを使用

docker run -d \
  --name searxng-mcp \
  -p 9000:9000 \
  -e SEARXNG_URL="https://searxng.abc.com" \
  muzihuaner/searxng-mcp:latest

アクセスアドレス

デプロイ完了後、MCP エンドポイントの形式は次のとおりです:

http://<你的服务器域名或IP>:<端口>/mcp

例:http://localhost:9000/mcp または https://mcp.your-domain.com/mcp

クライアント設定

Streamable HTTP をサポートする MCP クライアントでは、サービスアドレスを上記の /mcp エンドポイントに設定するだけです。例:

{
  "mcpServers": {
    "searxng": {
      "url": "http://localhost:9000/mcp"
    }
  }
}

ツール説明

search(query: str) -> str

キーワードに基づいて SearXNG 検索を呼び出し、各結果エントリの content テキストを改行で連結して返します。

  • query: 検索キーワード。

  • 戻り値: 検索結果のテキスト内容。リクエストが失敗した場合は False を返します。

並行性とパフォーマンス

测试结果示例(局域网 / 上游 `so.xxx.cn`):

総リクエスト数: 100 並行ワーカー: 50 成功: 100 失敗: 0 総所要時間(秒): 67.68 スループット(QPS): 1.48 平均遅延(秒): 27.284 最小遅延(秒): 7.203 最大遅延(秒): 44.418


> 注意:端到端延迟主要取决于 SearXNG 上游实例的响应速度(本例平均约 27s 来自上游 `so.xxx.cn` 较慢),服务本身可稳定承载并发且零失败。若需提升吞吐,可:
> - 换用响应更快 / 自托管的 SearXNG 实例(通过 `SEARXNG_URL` 指定);

よくある質問

Q: クライアントが Missing session ID エラーを報告しますか? A: このサービスは stateless_http=True を有効にしており、セッションは不要です。それでもエラーが発生する場合は、クライアントが /mcp エンドポイントを指していることを確認してください。

Q: 本番環境で CORS を厳しくするにはどうすればよいですか? A: Server.py の CORSMiddleware を編集し、allow_origins=["*"] を具体的なオリジンリスト(例:["https://your-domain.com"])に変更します。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables privacy-focused web search via SearXNG for MCP clients, allowing users to perform searches with customizable parameters through natural language.
      180 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides a free web search tool to MCP clients by connecting to a self-hosted SearXNG metasearch instance, enabling users to search the web with customizable parameters like categories and time range.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP-compatible clients to perform web searches through a self-hosted SearXNG instance, with support for configurable languages, categories, time ranges, and safe search settings.
      2
      554 npm
      MIT