SearXNG MCP Server

基本能力

产品定位

SearXNG MCP Server 是一个为 AI 代理提供隐私保护的搜索能力的 MCP 服务器模板。

核心功能

• 集成 SearXNG 搜索引擎，提供强大的网络搜索能力
• 支持 SSE 和 stdio 两种传输协议
• 提供 Docker 容器化部署选项
• 支持自定义工具、资源和提示的扩展

适用场景

• AI 代理需要隐私保护的搜索功能
• 开发者需要构建自定义的 MCP 服务器
• 需要与 MCP 兼容客户端集成的场景

工具列表

• search 工具：支持多种搜索参数，包括查询字符串、搜索类别、搜索引擎、语言等

常见问题解答

• 如何配置 SearXNG 实例？ 需要运行一个 SearXNG 实例，可以通过 Docker 快速部署
• 支持哪些传输协议？ 支持 SSE 和 stdio 两种传输协议
• 如何扩展功能？ 可以通过添加 @mcp.tool() 装饰器的方法来添加自定义工具

使用教程

使用依赖

• Python 3.9+
• 运行中的 SearXNG 实例（本地或远程）
• Docker（可选，用于容器化部署）
• uv（可选，用于快速 Python 依赖管理）

SearXNG 服务器安装

docker run -d --name=searxng -p 32768:8080 -v "/root/searxng:/etc/searxng" \
  -e "BASE_URL=http://0.0.0.0:32768/" \
  -e "INSTANCE_NAME=home" \
  --restart always searxng/searxng

安装教程

使用 uv 安装

pip install uv
git clone https://github.com/The-AI-Workshops/searxng-mcp-server.git
cd searxng-mcp-server/dev/searXNG-mcp
uv pip install -r requirements.txt
nano .env

使用 Docker 安装

docker build -t mcp/searxng-mcp .
docker run -d --env-file ./.env -p 32769:32769 mcp/searxng-mcp

调试方式

使用 uv 运行

uv run dev/searXNG-mcp/server.py

使用 Docker 运行

docker build -t mcp/searxng-mcp .
docker run --rm -it -p 32769:32769 --env-file dev/searXNG-mcp/.env -v $(pwd)/dev/searXNG-mcp:/app mcp/searxng-mcp

许可证

该项目遵循 None 开源许可条款。