用途
searxng_http_mcp 是一个自包含的 MCP（Model Context Protocol）服务器，用于封装 SearXNG——一个免费、尊重隐私、可从 200 多个搜索引擎聚合结果的元搜索引擎。它让支持 MCP 的客户端（如 Claude Code、Cursor、VS Code Copilot 等）能够直接调用搜索、自动补全和引擎发现能力。
主要能力
- 🔍 200+ 搜索引擎：通过 SearXNG 聚合 Google、Bing、DuckDuckGo、Brave 等。
- 📂 30+ 类别：新闻、图片、视频、科学、IT 等。
- 📄 多页扇出：每次调用最多获取 5 页结果。
- 💡 自动补全建议：发现相关搜索词。
- 🗂 引擎发现：按类别分组查询可用引擎。
- 🎯 Token 高效：结果仅保留核心内容。
- 📦 自包含：SearXNG 已内置到 Docker 镜像中。
- 🔄 三种传输方式：HTTP 服务器、Docker stdio 和 uvx 独立运行。
- 🔐 认证：支持 x-api-key 与 HTTP Basic Auth。
- 🌐 反向代理：在同一端口提供 SearXNG Web UI。
- ⚡ 动态工具描述：启动时注入实时类别列表。
- 📐 丰富的 JSON Schema：每个参数均带枚举约束、范围限制和描述。
MCP 工具共三个：search（聚合搜索，返回 results、answers、suggestions、corrections、infoboxes）、autocomplete（自动补全）和 engine discovery（无参数，按类别返回已启用引擎列表）。项目有意将工具面控制在三个以内：URL 抓取由客户端专用工具处理，多查询并行搜索由客户端编排，研究/综合由 LLM 层完成。
使用方式
支持三种模式：
- HTTP 模式（默认）：部署一次，任意客户端通过 http://YOUR_HOST:YOUR_PORT/mcp/ 连接。设置 API_KEY 后可启用 x-api-key 头或 HTTP Basic Auth（浏览器登录时用户名留空，密码填 API key）。
- 本地模式：无需服务器，在客户端中作为 stdio MCP 服务器运行。
- uvx 模式：若已有 SearXNG 实例，可设置 SEARXNG_URL（默认 http://127.0.0.1:8080）后运行。需 Python 3.14+。
客户端配置因客户端而异：字段名可能是 mcpServers、mcp.servers、顶层 mcp 键、servers、mcp_servers 等；Claude Code 需 "type": "http"，Cline 需 "type": "streamableHttp"，Windsurf 使用 serverUrl 而非 url，Codex 和 Hermes 使用 mcp_servers（TOML/YAML）。文档给出了 Claude Desktop、Claude Code CLI/JSON、Codex、Cursor、VS Code、Windsurf、Cline、OpenCode、Hermes、ZCode、Kilo Code、Pi 等客户端的配置示例。
可访问 http://YOUR_HOST:YOUR_PORT/ 配置 SearXNG 的搜索引擎、语言等设置；挂载配置目录可持久化。SearXNG 首次启动会生成 settings.yml，容器自动启用 MCP 工具所需的 JSON 格式输出。
适用场景
适用于需要在 AI 客户端中进行隐私友好、多引擎聚合搜索的开发者和用户；支持作为 Claude Code、GitHub Copilot CLI、OpenAI Codex CLI 的插件使用，插件包含 /web-search-via-searxng 技能、web-searcher 研究子代理（多语言并行搜索、来源可信度分级、交叉验证、WebFetch 深度阅读、多轮迭代搜索、时效性评估、脚注引用）等。
限制
- 具体收费、价格信息暂未提供。
- uvx 模式与插件运行需要 Python 3.14+ 且已有 SearXNG 实例。
- Docker stdio 插件模式需安装 Docker。
- 远程插件模式需设置 SEARXNG_MCP_URL 和 SEARXNG_API_KEY 环境变量。
- Web UI 中的配置更改仅在容器生命周期内保持，除非挂载配置目录。
- 项目代码采用 MIT 许可，SearXNG 本身采用 AGPL-3.0-or-later。
