SearXNG MCP Server

基本能力

产品定位

SearXNG MCP Server 是一个提供网页搜索能力的服务，通过集成 SearxNG API 实现。

核心功能

• Web Search: 支持通用查询、新闻、文章搜索，并具有分页功能。
• Pagination: 可以控制返回结果的大小和数量。

适用场景

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

工具列表

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

常见问题解答

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

使用教程

使用依赖

需要先设置 SEARXNG_URL 环境变量。

安装教程

通过 Smithery 安装

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

使用 NPX

{
  "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 和搜索参数来测试服务功能。

许可证

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