SearXNG Search Connector MCP服务器使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，它将 SearXNG 搜索引擎的功能集成到 MCP 框架中，使得 Agent 系统（如LLM客户端）可以通过标准化的 MCP 接口调用 SearXNG 进行网页搜索。

主要功能点

网页搜索工具: 提供 'search' 工具，允许 Agent 系统通过 SearXNG 搜索互联网信息，聚合来自多个搜索引擎的结果。
可配置 SearXNG URL: 支持自定义 SearXNG 服务器的 URL，默认为 'http://localhost:8080'。
MCP 标准接口: 遵循 MCP 协议，易于与各种 MCP 客户端集成。
工具和 Prompt 支持: 同时提供 'search' 工具和 'search' Prompt，方便 Agent 系统以不同方式调用搜索功能。

安装步骤

克隆仓库: 从 GitHub 克隆 'MCP-searxng' 仓库到本地。

git clone https://github.com/SecretiveShell/MCP-searxng
cd MCP-searxng

安装依赖 (如果需要): 根据您的运行环境，可能需要安装项目依赖。通常情况下，如果使用 'uvx' 或 'uv' 运行，依赖管理会自动处理。

服务器配置

MCP 客户端需要配置连接到 'SearXNG Search Connector' MCP 服务器的信息。以下是两种常用的配置方式，选择其一配置到您的 MCP 客户端中。

配置方式一：使用 'uvx' (推荐)

如果您的环境已安装 'uvx'，可以使用以下 JSON 配置。

{
  "mcpServers": {
    "searxng": {
      "command": "uvx",
      "args": [
        "mcp-searxng"
      ]
    }
  }
}

'server name': 'searxng' - 服务器名称，用于在客户端中标识和引用。
'command': 'uvx' - 启动服务器的命令，这里使用 'uvx' 运行。
'args': '["mcp-searxng"]' - 传递给 'uvx' 命令的参数，'mcp-searxng' 会自动查找并运行项目入口。

配置方式二：使用 'uv' 和本地仓库路径

如果您希望指定本地仓库路径或者使用 'uv' 命令直接运行，可以使用以下 JSON 配置。请将 '/absoloute/path/to/MCP-searxng/' 替换为克隆仓库的实际绝对路径。

{
  "mcpServers": {
    "searxng": {
      "command": "uv",
      "args": [
        "--project",
        "/absoloute/path/to/MCP-searxng/",
        "run",
        "/absoloute/path/to/MCP-searxng/mcp-searxng/main.py"
      ]
    }
  }
}

'server name': 'searxng' - 服务器名称，同上。
'command': 'uv' - 启动服务器的命令，这里使用 'uv' 运行。
'args':
- '"--project", "/absoloute/path/to/MCP-searxng/"' - 指定项目路径为您的本地仓库路径。请替换为实际路径。
- '"run", "/absoloute/path/to/MCP-searxng/mcp-searxng/main.py"' - 运行项目中的 'main.py' 文件，作为服务器入口。请替换为实际路径。

自定义 SearXNG URL

如果您需要连接到非默认的 SearXNG 服务器，可以设置环境变量 'SEARXNG_URL'。例如，在运行服务器之前执行：

export SEARXNG_URL="your_searxng_server_url"

注意: 如果您使用了 'claude desktop' 等 MCP 客户端，在重新运行服务器前，请确保杀掉之前的服务器进程，避免端口占用等问题。

基本使用方法

启动 MCP 服务器: 根据您选择的配置方式，在克隆的仓库目录下，使用 'uvx mcp-searxng' 或 'uv --project /absoloute/path/to/MCP-searxng/ run /absoloute/path/to/MCP-searxng/mcp-searxng/main.py' 命令启动服务器。
配置 MCP 客户端: 将上述生成的 JSON 配置信息添加到您的 MCP 客户端配置中，确保客户端能够连接到 'searxng' 服务器。
在 Agent 系统中使用: 您的 Agent 系统可以通过 MCP 客户端调用 'searxng' 服务器提供的 'search' 工具或 'search' Prompt，实现网页搜索功能。例如，调用 'search' 工具时，需要提供 'query' 参数作为搜索关键词。

关键词