基本能力
产品定位
SearXNG MCP Server 是一个专注于隐私保护的元搜索工具,能够聚合多个搜索引擎的结果,提供无跟踪、无用户画像的搜索体验。
核心功能
- 元搜索:聚合多个搜索引擎的结果
- 隐私保护:无跟踪,无用户画像
- 多类别支持:支持通用、新闻、科学、文件、图片、视频等多种搜索类别
- 语言支持:支持特定语言或所有语言的搜索
- 时间范围过滤:可按天、周、月或年过滤结果
- 安全搜索:提供三个级别的安全搜索过滤
- 后备支持:支持多个 SearXNG 实例以提高可靠性
适用场景
- 需要聚合多个搜索引擎结果的场景
- 注重隐私保护的搜索需求
- 需要特定语言或时间范围过滤的搜索
工具列表
- web_search
- 执行跨多个引擎的元搜索
- 输入参数:
query
(字符串):搜索词page
(数字,可选):页码(默认:1)language
(字符串,可选):语言代码(如 'en', 'all', 默认: 'all')categories
(数组,可选):搜索类别(默认: ['general'])- 可用类别:"general", "news", "science", "files", "images", "videos", "music", "social media", "it"
time_range
(字符串,可选):时间过滤器(day/week/month/year)safesearch
(数字,可选):安全搜索级别(0: 无, 1: 中等, 2: 严格, 默认: 1)
常见问题解答
- 如何设置多个 SearXNG 实例?
- 通过环境变量
SEARXNG_INSTANCES
设置,多个实例 URL 用逗号分隔 - 如何自定义 User-Agent?
- 通过环境变量
SEARXNG_USER_AGENT
设置
使用教程
使用依赖
需要本地运行 SearXNG 实例。可以使用 Docker 快速启动:
```bash
创建配置目录
mkdir -p searxng
创建配置文件
tee searxng/settings.yml << EOF
use_default_settings: true
server:
bind_address: "0.0.0.0"
secret_key: "CHANGE_THIS_TO_SOMETHING_SECURE" # 生成随机密钥
port: 8080
search:
safe_search: 0
formats:
- html
- json
engines:
- name: google
engine: google
shortcut: g
-
name: duckduckgo
engine: duckduckgo
shortcut: d -
name: bing
engine: bing
shortcut: b
server.limiter: false
EOF
启动容器
docker run -d \
--name searxng \
-p 8080:8080 \
-v "$(pwd)/searxng:/etc/searxng" \
searxng/searxng
```
安装教程
bash
npm install -g @kevinwatt/mcp-server-searxng
调试方式
```bash
测试 JSON API
curl -v 'http://localhost:8080/search?q=test&format=json'
或在浏览器中访问
http://localhost:8080/search?q=test
```