searxng-mcp-server

🚀 SearXNG MCP 服务器

SearXNG MCP 服务器为用户提供了便捷的搜索服务，支持多种安装方式和配置选项，还能与不同客户端集成，满足多样化的使用需求。

🚀 快速开始

SearXNG MCP 服务器可通过 Docker 或本地环境进行安装，安装完成后，根据需求配置相关参数，即可与客户端集成使用。

📦 安装指南

环境要求

• 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 开源协议。