🚀 SearXNG MCP 服务器

SearXNG MCP 服务器是一个集成到 SearXNG 的 MCP 服务器实现，专注于提供具备隐私保护的元搜索功能，能有效结合多个搜索引擎的结果，为用户带来更全面、安全的搜索体验。

✨ 主要特性

• 元搜索：将多个搜索引擎的结果进行整合，让用户能一次性获取更广泛的信息。
• 隐私-focused：不进行用户跟踪，也不会构建用户画像，充分保护用户隐私。
• 多类别支持：支持通用、新闻、科学、文件、图片、视频等多种搜索类别。
• 语言支持：用户可指定特定语言进行搜索，也能选择搜索所有语言的内容。
• 时间范围过滤：可按天、周、月、年对搜索结果进行筛选，方便获取特定时间段内的信息。
• 安全搜索：提供三个级别的安全搜索过滤，分别为无、中等、严格，满足不同用户的安全需求。
• 备用支持：通过多个 SearXNG 实例确保服务的可靠性，减少服务中断的风险。

📦 安装指南

使用以下命令进行全局安装：

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

💻 使用示例

基础用法

直接运行 MCP 服务器：

mcp-server-searxng

高级用法

与 Dive Desktop 结合使用：

1. 在 Dive Desktop 中点击 "+ 添加 MCP 服务器"。
2. 复制并粘贴以下配置：

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ]
    }
  }
}

3. 点击"保存"以完成 MCP 服务器的安装。

📚 详细文档

web_search

• 功能：执行多个引擎的元搜索。
• 输入参数：
  • query (字符串)：必填项，搜索词。
  • page (数字，可选)：页码，默认值为 1。
  • language (字符串，可选)：语言代码，例如 'en' 表示英语，'all' 表示所有语言，默认值为 'all'。
  • categories (数组，可选)：搜索类别，默认值为 ['general']。可用值包括 "general", "news", "science", "files", "images", "videos", "music", "social media", "it"。
  • time_range (字符串，可选)：时间过滤器，可按天/周/月/年进行筛选。
  • safesearch (数字，可选)：安全搜索级别，0 表示无过滤，1 表示中等过滤，2 表示严格过滤，默认值为 1。

🔧 技术细节

开发步骤

git clone https://github.com/kevinwatt/mcp-server-searxng.git
cd mcp-server-searxng
npm install
npm run build
npm start

先决条件

你需要一个本地运行的 SearXNG 实例。以下是使用 Docker 运行 SearXNG 的详细步骤：

快速开始

# 创建配置目录
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/searx:latest

配置文件说明

• use_default_settings: true：使用默认设置，无需额外配置。
• bind_address: "0.0.0.0"：允许外部访问。
• secret_key：用于 API 认证，请替换为随机字符串。
• port: 8080：指定端口。

环境变量

docker run -d \
  --name searxng \
  -p 8080:8080 \
  -e SEARXNG_BEANSTALKD=redis://beanstalkd:1327 \
  -v $(pwd)/searxng:/etc/searxng \
  searxng/searx:latest

多实例支持

在 MCP 服务器中配置多个 SearXNG 实例：

{
    "mcpServers": {
        "searxng": {
            "name": "searxng",
            "command": "npx",
            "args": [
                "-y",
                // 此处原文档未完整展示，推测后续还有内容
            ]
        }
    }
}

📄 许可证

此 MCP 服务器根据 MIT License 许可。有关详细信息，请参阅 LICENSE 文件。