
SearxNG MCP Server

2025.04.11
1
Python隐私搜索AI集成搜索工具
SearxNG MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,通过 SearxNG 提供隐私保护的网页搜索功能,专为大型语言模型(LLMs)设计。该服务简化了搜索结果的格式,优化了与 LLMs 的通信效率,确保在有限的上下文窗口中最大化信息价值。
View on GitHub
Overview
基本能力
产品定位
SearxNG MCP Server 是一个隐私保护的网页搜索服务,专为 AI 助手和大型语言模型(LLMs)设计,通过 MCP 协议提供高效的搜索能力。
核心功能
- 通过 SearxNG 提供隐私保护的网页搜索
- 为 LLMs 优化的简洁 API
- 兼容 Claude Desktop 及其他 MCP 兼容客户端
- 可配置的搜索参数
- 为 LLMs 优化的格式化搜索结果
适用场景
- AI 助手需要实时网页搜索功能
- 需要隐私保护的搜索解决方案
- LLMs 集成网页搜索能力
工具列表
- pipx/uvx:无需安装即可运行服务
- Docker:容器化部署
- Python:直接安装运行
常见问题解答
- 如何配置 SearxNG 实例?通过环境变量
SEARXNG_MCP_SEARXNG_URL
设置 - 支持哪些传输协议?支持 STDIO(默认)和 SSE 两种协议
- 日志级别设置过高可能导致什么问题?DEBUG 或 INFO 级别的日志可能破坏与某些应用程序的集成
使用教程
使用依赖
- Python 3.10 或更高版本
- SearxNG 实例(公共或自托管)
安装教程
选项1:无需安装运行(推荐)
# 使用 pipx
pip install pipx
pipx run searxng-simple-mcp
# 或使用 uvx
pip install uvx
uvx run searxng-simple-mcp
选项2:从 PyPI 或源码安装
# 从 PyPI 安装
pip install searxng-simple-mcp
# 或从源码安装
git clone https://github.com/Sacode/searxng-simple-mcp.git
cd searxng-simple-mcp
pip install -e .
选项3:使用 Docker
# 拉取 Docker 镜像
docker pull ghcr.io/sacode/searxng-simple-mcp:latest
# 运行容器
docker run --rm -i ghcr.io/sacode/searxng-simple-mcp:latest
调试方式
# 直接运行服务器
python -m searxng_simple_mcp.server
# 使用自定义配置运行
python -m searxng_simple_mcp.server --searxng-url https://your-instance.example.com