SearXNG MCP Server

SearXNG MCP Server

site icon
2025.02.17 1
JavaScript元搜索隐私保护搜索工具
SearXNG MCP Server 是一个与 SearXNG 集成的 MCP 服务器实现,提供以隐私为核心的元搜索功能。它能够聚合多个搜索引擎的结果,同时保护用户隐私,不进行跟踪或用户画像。
View on GitHub

Overview

基本能力

产品定位

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 快速启动:

# 创建配置目录
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

安装教程

npm install -g @kevinwatt/mcp-server-searxng

调试方式

# 测试 JSON API
curl -v 'http://localhost:8080/search?q=test&format=json'

# 或在浏览器中访问
http://localhost:8080/search?q=test

许可证

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