🚀 使用 Searx 搜索引擎与 MCP 协议
Searx 是一个开源且去中心化的搜索引擎，支持通过 MCP（机器控制协议）接口进行交互。本文档将指导你如何配置并运行 Searx 与 MCP 协议的结合使用，助你轻松开启搜索之旅。
🚀 快速开始
若你想使用 Searx 搜索引擎与 MCP 协议，需依次完成安装、配置、运行等步骤，下面为你详细介绍。
📦 安装指南
要开始使用，请按照以下步骤安装必要的工具：
- Python 环境
- 安装 Python （推荐使用版本 3.6 或更高）
- 安装 pip：
python get-pip.py
- 安装依赖项
- 使用 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.0SEARX_MCP_PORT：指定 MCP 服务器的端口，默认为8080SEARX_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 文件。