SearxNG MCP Server

SearxNG MCP Server

site icon
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:直接安装运行

常见问题解答

  1. 如何配置 SearxNG 实例?通过环境变量 SEARXNG_MCP_SEARXNG_URL 设置
  2. 支持哪些传输协议?支持 STDIO(默认)和 SSE 两种协议
  3. 日志级别设置过高可能导致什么问题?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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。