SearXNG MCP Server

基本能力

产品定位

mcp-searxng 是一个提供网页搜索能力的 MCP 服务器，适用于需要集成搜索功能的应用程序。

核心功能

• 网页搜索：支持通用查询、新闻和文章搜索。
• 分页功能：可以控制返回结果的大小和数量。

适用场景

• 需要集成网页搜索功能的应用程序。
• 需要分页控制搜索结果的场景。

工具列表

• searxng_web_search
• 执行带有分页的网页搜索。
• 输入参数：
  • query (string): 搜索关键词。
  • count (number, optional): 每页结果数量（默认 20）。
  • offset (number, optional): 分页偏移量（默认 0）。

常见问题解答

1. 如何设置 SEARXNG_URL？
2. 从 公共实例列表 中选择一个 SearxNG 实例或使用本地环境。
3. 设置 SEARXNG_URL 环境变量为实例 URL。
4. 默认值为 http://localhost:8080。

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @ihor-sokoliuk/server-searxng --client claude

通过 NPX 安装

在 claude_desktop_config.json 中添加以下配置：

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y"
        "<full path to mcp-searxng repo>/"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

通过 Docker 安装

构建镜像：

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

在 claude_desktop_config.json 中添加以下配置：

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

调试方式

确保 SEARXNG_URL 环境变量已正确设置，并运行以下命令测试搜索功能：

npx -y @smithery/cli install @ihor-sokoliuk/server-searxng --client claude

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。