SearXNG MCP Server

截至 2026-07-29，以下功能对比基于官方的 Brave MCP、 Exa MCP 和 Firecrawl MCP 项目。 “分页”指提供页面或偏移量控制。“可自托管”指搜索服务可在你控制的环境中运行。“免费／无需 API 密钥”指此 MCP 服务无需付费搜索供应商的 API 密钥；但你仍需运行或选择底层 SearXNG 实例。

npm install -g mcp-searxng

{
  "mcpServers": {
    "searxng": {
      "command": "mcp-searxng",
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

预构建镜像：

docker pull isokoliuk/mcp-searxng:latest

可以使用 Cosign 验证镜像签名——请参阅 SECURITY.md 了解操作说明。

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEARXNG_URL",
        "isokoliuk/mcp-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

要传递其他环境变量，请在 args 中添加 -e VAR_NAME，并将该变量添加到 env 中。 要集成浏览器求解器，请传递 FLARESOLVERR_URL、BYPARR_URL 或两者，并确保此容器可以访问已配置的服务。双模式采用固定的 FlareSolverr 优先顺序，不会自动反向故障转移。安全的渲染后 HTML 和明确的 Byparr PDF 内容会直接读取；含义不明确的内容会使用受控重放处理，并在符合条件的读取失败时进行有限故障转移。完整行为说明和 Docker Compose 示例请参阅 URL Reader Controls。

在本地构建：

docker build -t mcp-searxng:latest -f Dockerfile .

使用上方相同的配置，并将 isokoliuk/mcp-searxng:latest 替换为 mcp-searxng:latest。

docker-compose.yml：

services:
  mcp-searxng:
    image: isokoliuk/mcp-searxng:latest
    stdin_open: true
    environment:
      - SEARXNG_URL=${SEARXNG_URL:?Set SEARXNG_URL in the environment}
      # Add optional variables as needed — see CONFIGURATION.md

此仓库跟踪的 Compose 文件有意仅支持 STDIO，且不发布任何网络端口；MCP 客户端使用绝对 Compose 文件路径和 docker compose run --rm -T 启动，而不是使用 docker compose up。-T 标志可避免分配伪终端，从而使 MCP JSON-RPC 通过原始标准输入和输出传输。除非 MCP 客户端提供 SEARXNG_URL，否则 Compose 会在启动前失败。

MCP 客户端配置：

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "compose",
        "-f", "/absolute/path/to/docker-compose.yml",
        "run", "--rm", "-T", "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

如果你之前将此仓库跟踪的文件用作运行在 8080 端口上的 HTTP 服务，请将 HTTP 设置放入未跟踪的 docker-compose.override.yml 中：

services:
  mcp-searxng:
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - MCP_HTTP_PORT=8080
      - MCP_HTTP_HOST=0.0.0.0

此处的 0.0.0.0 是容器侧的绑定地址；主机侧端口仍仅限回环访问。此覆盖配置不含身份验证，仅适用于临时的单主机迁移场景。在添加同机容器或将服务暴露到本机以外之前，请遵循强化的部署指南。