基本能力
产品定位
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 服务器安装
bash
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 安装
bash
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 安装
bash
docker build -t mcp/searxng-mcp .
docker run -d --env-file ./.env -p 32769:32769 mcp/searxng-mcp
调试方式
使用 uv 运行
bash
uv run dev/searXNG-mcp/server.py
使用 Docker 运行
bash
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
