← 返回目录

SearXNG Search

社区

通过 SearXNG 进行私密网页搜索。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 64 / 230
Stars: ★ 1.3k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 20+ · Docker
凭据: 无需凭据
许可证: MIT
最近提交: 13 天前
工具数: 4

61FMRS · C

基于仓库描述、服务器清单和 README：这是 MIT 许可的第三方 SearXNG MCP 服务器，版本 1.12.0，默认使用 stdio，并提供可选 Streamable HTTP 传输。

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

10/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: README 和清单详细描述了 STDIO、HTTP、搜索、建议、实例信息及 URL 读取工具，且声明了输入限制、缓存、故障转移和错误场景，因此正常路径看起来可行。但仅提供 README 和 manifest，没有源代码、CI 工作流或已提交测试来验证 MCP 初始化、工具列表一致性、依赖行为和边界错误处理；按静态校准不超过 12，故扣分。
安全与权限 12/20: 证据显示主要凭据通过环境变量传入，并标记为 secret；URL 读取默认阻断内部地址和重定向，HTTP 模式提供可选令牌认证、CORS 和限流，且没有声明写入、删除、支付或远程命令功能。扣分原因是仅有文档级声明，缺少源代码审计、完整数据流、代理和 TLS 配置的验证，也没有看到更细粒度权限控制或危险请求确认机制。
维护活跃度 10/20: 项目使用 MIT 许可证，仓库未归档，已有 1.12.0 版本信息，且存在公开仓库和 npm 发布路径，这些是基本维护信号。扣分原因是未提供提交历史、发布节奏、依赖更新、问题响应记录、维护者责任或安全响应渠道；星数和开放 issue 数不能作为维护质量加分依据。
文档质量 16/20: README 覆盖安装方式、STDIO/HTTP 配置、环境变量入口、工具参数、分页与过滤、内容类型、SSRF 防护、HTML 回退、故障转移、故障排查和 Docker 示例，信息层次较完整。仍缺少可独立审查的配置文件、安全策略实现、成本/资源上限的完整说明以及测试证据；认证、代理和 TLS 细节被外部配置文档引用但未提供。
安装易用性 13/20: README 提供了 npx、全局 npm、Docker、Compose 和主流 MCP 客户端配置示例，并明确唯一必需变量是 SearXNG 实例 URL，HTTP 端点和本地绑定也有说明。扣分原因是用户必须先准备并配置可用的 SearXNG 实例，JSON API、网络、TLS 或认证问题可能需要手工排查；没有 CI、集成测试或可验证的端到端连接证据。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

希望自托管搜索基础设施的用户
重视隐私且已有 SearXNG 实例的团队
需要分页搜索和 URL 内容读取的 MCP 客户端用户

不适合谁

没有可用 SearXNG 实例的用户
需要原生安装为 SearXNG 插件的用户
需要读取 PDF、媒体、压缩包或其他二进制下载的场景

所需权限

需要访问配置的 SearXNG_URL；该变量在清单中标记为必需且机密。
可选使用 AUTH_USERNAME 和 AUTH_PASSWORD 连接启用旧式全局 Basic Auth 的 SearXNG 实例。
搜索查询会传递给外部搜索服务；web_url_read 会请求用户指定的 URL。

风险与副作用

隐私保护取决于所连接的 SearXNG 实例及其配置。
搜索查询可能被传递给 SearXNG 所使用的外部搜索服务。
读取任意 URL 会产生出站请求；默认会阻止私有或内部 URL 及重定向，但部署 HTTP 服务时仍应启用并配置安全加固。
HTML 回退依赖实例页面结构，可能结果较少且缺少相关性分数和引擎名称。

安装接入

准备工作

运行环境：Node.js 20+ · Docker

SEARXNG_URL 必填你的 SearXNG 实例 URL（可用分号分隔多个副本），使用自建或可信实例时从实例管理员处获取。

AUTH_USERNAME 可选密钥旧版全局 SearXNG Basic Auth 用户名，仅当实例启用 Basic Auth 时设置。

AUTH_PASSWORD 可选密钥旧版全局 SearXNG Basic Auth 密码，仅当实例启用 Basic Auth 时设置。

其他可选配置项（12 个）

SEARXNG_DEFAULT_RESPONSE_FORMAT 可选搜索调用未指定 response_format 时的默认输出格式（text 或），由运营者自行设定。

SEARXNG_MAX_RESULTS 可选单次搜索结果数的运营者上限，按需设置。

SEARXNG_FANOUT 可选开启后对所有健康副本并行查询并合并结果，按需设置。

SEARXNG_HTML_FALLBACK 可选设为 true 时，实例拒绝 format= 会自动回退解析 HTML 结果页。

URL_READ_MAX_CONTENT_LENGTH_BYTES 可选 URL 读取和 PDF 提取的内容大小上限（字节），按需设置。

FLARESOLVERR_URL 可选 FlareSolverr 浏览器求解服务地址，用于绕过反爬挑战，自部署 FlareSolverr 后填写。

BYPARR_URL 可选 Byparr 浏览器求解服务地址，与 FlareSolverr 配合使用，自部署 Byparr 后填写。

MCP_HTTP_PORT 可选以 HTTP 传输模式运行时的监听端口，仅独立进程模式需要。

MCP_HTTP_HOST 可选 HTTP 模式绑定地址，默认 127.0.0.1，远程/容器部署设为 0.0.0.0。

MCP_HTTP_STATELESS 可选设为 true 时启用无状态 POST-only 兼容模式，用于 serverless/水平扩展部署。

MCP_HTTP_HARDEN 可选开启 HTTP 加固模式，对外暴露服务前建议启用。

MCP_HTTP_TRUST_PROXY 可选配置反向代理信任，使限流和日志使用正确的客户端 IP。

将安装配置加入 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"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add searxng -e SEARXNG_URL=YOUR_SEARXNG_INSTANCE_URL -- npx -y mcp-searxng

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应看到 searxng_web_search、searxng_search_suggestions、searxng_instance_info、web_url_read 四个工具；让模型执行一次搜索，若能返回结果即证明已正确连接到 SEARXNG_URL 指定的实例。

常见排障

确认 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 的最新版本，返回前 5 条结果
帮我读取 https://docs.searxng.org 页面内容并转成 Markdown
给我一些关于“隐私搜索引擎”的搜索自动补全建议
列出当前 SearXNG 实例支持的分类和启用的引擎

工具能力 4

searxng_web_search 只读

执行支持分页、时间范围、语言、安全搜索、相关性过滤、分类和引擎筛选的网页搜索，并返回格式化文本或原始 JSON。

searxng_search_suggestions 只读

通过 SearXNG 获取搜索查询自动补全建议。

searxng_instance_info 只读

发现可用 SearXNG 实例的分类、引擎、默认设置、本地化选项和插件。

web_url_read 只读

读取 URL 内容并转换为 Markdown；支持 HTML、JSON、纯文本及章节、段落范围和标题提取。

使用场景

在 AI 助手中进行基于 SearXNG 的网页、新闻和文章搜索

读取网页内容并提取章节、段落或标题

使用多个 SearXNG 副本实现故障转移或并行搜索

发现 SearXNG 实例支持的分类和搜索引擎

支持客户端

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

SearXNG Search 是一个独立的 MCP 服务器，将一个或多个 SearXNG 实例连接到 AI 助手，提供网页搜索、搜索建议、实例能力发现和 URL 内容读取。支持分页、时间范围、语言、安全搜索、相关性过滤、结果格式选择、缓存、故障转移及可选的 HTTP 传输。