SearXNG-MCP
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 インスタンスのルートアドレス(JSONを有効にする必要あり) |
|
| サービスがリッスンするアドレス |
|
| サービスがリッスンするポート |
ローカル実行
# 安装依赖(建议使用虚拟环境)
pip install -r requirements.txt
# 可选:自定义 SearXNG 实例(只需填根地址)
export SEARXNG_URL="https://your-searxng-instance"
# 启动服务
python Server.py起動後、MCP エンドポイントは次のとおりです:
http://localhost:9000/mcpDocker デプロイ
イメージのビルド
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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Unofficial Serper MCP — wraps the Serper Google Search API (serper.dev)
Web search and clean-text fetch MCP server (Tavily-powered, SSRF-guarded).
Unofficial Tavily MCP — wraps the Tavily API (tavily.com)
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables privacy-focused web search via SearXNG for MCP clients, allowing users to perform searches with customizable parameters through natural language.180 npmMIT
- FlicenseNot gradedqualityDmaintenanceProvides 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.-
- AlicenseAqualityBmaintenanceEnables 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.2550 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables web search through one or two SearxNG instances and retrieval of web pages, GitHub READMEs, and article text via MCP tools.-