SearXNG MCP 服务器

这是一个集成了 SearXNG API 的 MCP 服务器 实现，提供网页搜索功能。

功能

• 网页搜索：支持通用查询、新闻、文章，并支持分页。
• 分页控制：可以控制获取结果的页码。
• 时间过滤：按时间范围（天、月、年）过滤结果。
• 语言选择：按首选语言过滤结果。
• 安全搜索：控制搜索结果的过滤级别。

工具

• searxng_web_search

  • 执行带分页的网页搜索
  • 输入：
    • query (字符串)：搜索查询。该字符串会传递给外部搜索服务。
    • pageno (数字，可选)：搜索结果的页码，从 1 开始（默认值为 1）
    • time_range (字符串，可选)：按时间范围过滤结果 - 可选值："day"、"month"、"year"（默认：无）
    • language (字符串，可选)：结果的语言代码（如 "en"、"fr"、"de"）或 "all"（默认："all"）
    • safesearch (数字，可选)：安全搜索过滤级别（0：无，1：中等，2：严格）（默认：实例设置）

• web_url_read

  • 读取 URL 内容并将其转换为 markdown 格式
  • 输入：
    • url (字符串)：要获取并处理的 URL

配置

设置 SEARXNG_URL

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

使用身份验证

如果您使用的是受密码保护的 SearxNG 实例，可以设置用户名和密码进行 HTTP 基本身份验证：

• 将 AUTH_USERNAME 环境变量设置为您的用户名
• 将 AUTH_PASSWORD 环境变量设置为您的密码

与 Claude Desktop 一起使用

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 SearxNG 服务器：

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

NPX

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

NPM

npm install -g mcp-searxng

然后在您的 MCP 配置文件中：

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

Docker

使用 Docker Hub 上的预构建镜像

docker pull isokoliuk/mcp-searxng:latest

将此添加到您的 claude_desktop_config.json 中：

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

本地构建

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

使用

将此添加到您的 claude_desktop_config.json 中：

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

许可证

本 MCP 服务器遵循 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。更多详情请参阅项目仓库中的 LICENSE 文件。