SearXNG MCP Server
2025.03.31
6
JavaScript隐私搜索AI助手集成搜索工具
SearXNG MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在为 AI 助手提供通过 SearXNG 进行网络搜索的能力。SearXNG 是一个注重隐私的元搜索引擎。该服务支持零配置部署，自动从 SearX.space 选择随机公共实例，同时也支持通过基本认证连接私有实例。
View on GitHub
Overview
基本能力
产品定位
SearXNG MCP Server 是一个为 AI 助手提供网络搜索能力的中间件服务，通过 SearXNG 实现隐私保护的搜索功能。
核心功能
- 零配置设置：自动从 SearX.space 选择随机公共实例，无需额外部署
- 私有实例支持：支持连接到自托管的 SearXNG 实例，并可配置基本认证
- 可定制的搜索参数：支持多种搜索参数，如语言、时间范围、类别等
- 隐私优先：搜索结果注重隐私保护
- Markdown 格式的搜索结果：返回格式化的搜索结果
- 合理的默认值：所有参数都有合理的默认值
适用场景
- AI 助手需要执行网络搜索的场景
- 需要隐私保护的搜索应用
- 需要集成多个搜索引擎的应用
工具列表
- searxngsearch：使用 SearXNG 进行网络搜索的工具，支持多种参数配置
常见问题解答
- 公共实例可能不可用：可能会返回 "Request failed with status code 429" 错误
使用教程
使用依赖
- Node.js (v16 或更高版本)
- npm (v7 或更高版本)
- 访问 SearXNG 实例（自托管或公共实例）
安装教程
# 克隆仓库
git clone https://github.com/tisDDM/searxng-mcp.git
cd searxng-mcp
# 安装依赖
npm install
# 构建项目
npm run build
调试方式
# 如果全局安装
searxngmcp
# 如果从源代码安装
node build/index.js
配置
可以通过环境变量配置 SearXNG MCP 服务器：
- SEARXNG_URL：SearXNG 实例的 URL
- USE_RANDOM_INSTANCE：设置为 "false" 以禁用随机实例选择
- SEARXNG_USERNAME：私有实例的用户名
- SEARXNG_PASSWORD：私有实例的密码
在项目根目录的 .env 文件中设置这些变量：
SEARXNG_URL=https://searx.example.com
SEARXNG_USERNAME=your_username
SEARXNG_PASSWORD=your_password