🚀 使用 Searx 搜索引擎与 MCP 协议

Searx 是一款开源的去中心化搜索引擎，支持通过 MCP（机器控制协议）接口进行交互。本文档将为你详细指导如何配置并运行 Searx 与 MCP 协议的结合使用。

🚀 快速开始

你可以按照以下步骤，逐步完成 Searx 与 MCP 协议结合使用的配置与运行。

📦 安装指南

要开始使用，请按照以下步骤安装必要的工具：

1. Python 环境
   • 安装 Python （推荐使用版本 3.6 或更高）
   • 安装 pip：

python get-pip.py

2. 安装依赖项
   • 使用 pip 安装项目依赖：

pip install -r requirements.txt

📚 详细文档

配置

在 config.yml 文件中进行以下配置：

# MCP 服务器设置
mcp:
  server: searx
  host: "0.0.0.0"
  port: 8080
  timeout: 10
  max_results: 20
  language: all

# Searx 设置
searx:
  instance_name: "My Searx Instance"
  bind_interface: "0.0.0.0"
  port: 8081
  debug_mode: false

运行

使用 Docker

快速运行（无安装）

直接使用以下命令运行：

docker run -d --name searx-mcp -p 8080:8080 -p 8081:8081 searx/mcp-server

使用 Docker Compose

创建 docker-compose.yml 文件并添加以下内容：

version: '3'
services:
  searx-mcp:
    image: searx/mcp-server
    ports:
      - "8080:8080"
      - "8081:8081"

然后运行：

docker-compose up --detach

自定义配置

通过设置环境变量来调整行为：

• SEARX_MCP_HOST：指定 MCP 服务器的主机地址，默认为 0.0.0.0
• SEARX_MCP_PORT：指定 MCP 服务器的端口，默认为 8080
• SEARX_SEARCH_PORT：指定 Searx 搜索引擎的端口，默认为 8081

💻 使用示例

基础用法

查询示例

发送一个简单的搜索请求：

curl -X POST http://localhost:8080/mcp/search \
  -H "Content-Type: application/json" \
  -d '{"query":"机器学习","language":"all"}'

配置 MCP 客户端

在 MCP 客户端中添加 Searx 服务器的配置：

{
  "mcpServers": {
    "searx": {
      "url": "http://localhost:8080",
      "transport": "stdio"
    }
  }
}

🔧 技术细节

开发

安装开发依赖

npm install -D devDependencies

运行调试

npm run dev

打包发布

npm run build

📄 许可证

本项目遵循 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。