mcp-searxng

环境要求

• 已有一个启用 JSON 搜索格式的 SearXNG 实例（本项目不负责安装 SearXNG）
• Node.js 22 或更高版本（NPX / npm 安装方式需要，Docker 镜像自带运行时）
• 支持 MCP 的 AI 客户端，如 Claude Desktop、Cursor 等
• 可选：Docker，用于容器方式运行

安装与启动步骤

1. 1准备 SearXNG 实例

   必须已有一个开启 JSON 搜索格式的 SearXNG，且是你自建或信任的实例。本项目只做连接，不会安装 SearXNG。

2. 2安装 Node.js

   使用 NPX 或 npm 方式前，先装好 Node.js 22 或更高版本；用 Docker 则跳过此步。

3. 3写入客户端配置

   在客户端的 mcpServers 配置中加入 searxng 条目，把示例 URL 换成你自己的 SearXNG 地址；其他客户端配置格式不同。

   {
     "mcpServers": {
       "searxng": {
         "command": "npx",
         "args": ["-y", "mcp-searxng"],
         "env": { "SEARXNG_URL": "https://search.example.com" }
       }
     }
   }

   复制

4. 4NPX 直接运行

   客户端会按上面的配置自动拉起本地服务进程，无需手动常驻运行；本地 STDIO 模式不要设置 MCP_HTTP_PORT。

   npx -y mcp-searxng

   复制

5. 5或全局安装 npm 包

   想用全局命令 mcp-searxng 代替 npx 时执行；安装后把配置里的 command 改成 mcp-searxng。

   npm install -g mcp-searxng

   复制

6. 6或使用 Docker 镜像

   拉取官方预构建镜像，配置中把 command 换成 docker 并按 README 传入 -e SEARXNG_URL；也可从 Dockerfile 本地构建。

   docker pull isokoliuk/mcp-searxng:latest

   复制

7. 7重载并验证

   重载客户端，检查 MCP 工具清单里出现 searxng_web_search，然后让它实际搜一次；只看到工具不代表连通。

关键配置

如何确认成功

重载客户端后在 MCP 工具清单中看到 searxng_web_search，并用 {"query":"SearXNG"} 实际调用一次成功返回结果。

常见问题

注意事项

• 本项目不安装 SearXNG，务必先准备好启用 JSON 搜索格式的实例。
• Docker Compose 在客户端未提供 SEARXNG_URL 时会直接启动失败。
• 仓库自带的 Compose 文件只支持 STDIO，不发布任何网络端口。
• 8080 端口的 override 配置没有认证，仅作临时单机迁移用途，不要暴露到本机之外。