适合谁
- 希望自托管搜索基础设施的用户
- 重视隐私且已有 SearXNG 实例的团队
- 需要分页搜索和 URL 内容读取的 MCP 客户端用户
S
61FMRS · C
基于仓库描述、服务器清单和 README：这是 MIT 许可的第三方 SearXNG MCP 服务器，版本 1.12.0，默认使用 stdio，并提供可选 Streamable HTTP 传输。
SearXNG Search 是一个独立的 MCP 服务器，将一个或多个 SearXNG 实例连接到 AI 助手，提供网页搜索、搜索建议、实例能力发现和 URL 内容读取。支持分页、时间范围、语言、安全搜索、相关性过滤、结果格式选择、缓存、故障转移及可选的 HTTP 传输。
工具能力
searxng_web_search
执行支持分页、时间范围、语言、安全搜索、相关性过滤、分类和引擎筛选的网页搜索，并返回格式化文本或原始 JSON。
searxng_search_suggestions
通过 SearXNG 获取搜索查询自动补全建议。
searxng_instance_info
发现可用 SearXNG 实例的分类、引擎、默认设置、本地化选项和插件。
web_url_read
读取 URL 内容并转换为 Markdown；支持 HTML、JSON、纯文本及章节、段落范围和标题提取。
安装接入
将安装配置加入 MCP 客户端配置，并把 SEARXNG_URL 替换为你的 SearXNG 实例 URL。也可使用全局 npm 安装、Docker 或 Docker Compose。SEARXNG_URL 是唯一必需变量；如使用 HTTP 模式，需设置 MCP_HTTP_PORT 并连接 /mcp 端点。
claude_desktop_config.json
{"mcpServers":{"searxng":{"command":"npx","args":["-y","mcp-searxng"],"env":{"SEARXNG_URL":"YOUR_SEARXNG_INSTANCE_URL"}}}}
选型与风险
不适合谁
- 没有可用 SearXNG 实例的用户
- 需要原生安装为 SearXNG 插件的用户
- 需要读取 PDF、媒体、压缩包或其他二进制下载的场景
所需权限
- 需要访问配置的 SearXNG_URL；该变量在清单中标记为必需且机密。
- 可选使用 AUTH_USERNAME 和 AUTH_PASSWORD 连接启用旧式全局 Basic Auth 的 SearXNG 实例。
- 搜索查询会传递给外部搜索服务；web_url_read 会请求用户指定的 URL。
风险与副作用
- 隐私保护取决于所连接的 SearXNG 实例及其配置。
- 搜索查询可能被传递给 SearXNG 所使用的外部搜索服务。
- 读取任意 URL 会产生出站请求；默认会阻止私有或内部 URL 及重定向，但部署 HTTP 服务时仍应启用并配置安全加固。
- HTML 回退依赖实例页面结构，可能结果较少且缺少相关性分数和引擎名称。
常见排障
- 确认 SEARXNG_URL 指向可访问的 SearXNG 实例。
- 若出现 403，确认 SearXNG 的 search.formats 包含 json；无法修改实例时可启用 SEARXNG_HTML_FALLBACK=true。
- 检查 SearXNG 实例是否需要 AUTH_USERNAME 和 AUTH_PASSWORD。
- HTTP 部署时检查 MCP_HTTP_PORT、MCP_HTTP_HOST，并通过 /health 验证服务。
- TLS 检查失败时，检查企业代理或自定义 CA 配置。
使用场景
在 AI 助手中进行基于 SearXNG 的网页、新闻和文章搜索
读取网页内容并提取章节、段落或标题
使用多个 SearXNG 副本实现故障转移或并行搜索
发现 SearXNG 实例支持的分类和搜索引擎
支持客户端
Claude Desktop完整支持
Cursor完整支持