SearXNG MCP 服务器

安装步骤

环境要求

• Python 3.8 或更高版本
• Docker（可选）

安装方法

1. 使用 Docker 安装：

   docker run -d --name searxng-mcp-server -p 32769:32769 mcp/searxng-mcp-server
   

2. 本地安装：

   git clone https://github.com/your-repository.git
   cd searxng-mcp-server
   pip install -r requirements.txt
   python server.py
   

配置参数

网络配置

• HOST: 服务器绑定的地址，默认为 0.0.0.0
• PORT: 服务器监听的端口，默认为 32769

SearXNG 配置

• SEARXNG_BASE_URL: SearXNG 的基础 URL，例如 http://localhost:32768

日志配置

• LOG_LEVEL: 日志级别，可选值为 debug, info, warning, error, critical，默认为 info
• LOG_FILE: 日志文件路径，默认为 ./mcp_server.log

与客户端集成

使用 Windsurf 配置

在你的配置文件中添加以下内容：

{
  "mcpServers": {
    "searxng": {
      "transport": "sse",
      "serverUrl": "http://host.docker.internal:32769/sse"
    }
  }
}

使用 n8n 配置

在你的节点配置中设置：

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
               "-e", "TRANSPORT=stdio",
               "-e", "SEARXNG_BASE_URL=http://localhost:32768",
               "mcp/searxng-mcp-server"],
      "env": {
        "PORT": "32769"
      }
    }
  }
}

自定义服务器扩展

添加自定义工具

通过 @mcp.tool() 装饰器创建自定义工具方法。

配置生命周期函数

在 server.py 中添加：

def lifespan(app: FastAPI):
    # 初始化数据库连接或其他依赖项
    return {"startup": None, "shutdown": None}

SearXNG 搜索参数

• q: 必填，搜索查询字符串。
• categories: 激活的搜索分类，逗号分隔。
• engines: 激活的搜索引擎，逗号分隔。
• 其他高级参数如语言、页面数等，请参考 SearXNG 文档。

许可证

本项目采用 MIT License 开源协议。