hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Included as one of the search engines that SearXNG queries for results, configured with the shortcut 'd'.
Included as one of the search engines that SearXNG queries for results, configured with the shortcut 'g'.
Integrates with SearXNG to provide privacy-focused meta search capabilities, combining results from multiple search engines with features like language support, time range filtering, and safe search.

SearXNG MCP 服务器

与 SearXNG 集成的 MCP 服务器实现，提供以隐私为中心的元搜索功能。

特征

元搜索：整合来自多个搜索引擎的结果
注重隐私：不跟踪，不进行用户分析
多种类别：支持一般、新闻、科学、文件、图像、视频等
语言支持：以特定语言或所有语言搜索
时间范围过滤：按日、周、月或年过滤结果
安全搜索：三级安全搜索过滤
后备支持：多个 SearXNG 实例以确保可靠性

安装

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

用法

直接运行

mcp-server-searxng

使用Dive Desktop

在 Dive Desktop 中点击“+ 添加 MCP 服务器”
复制并粘贴此配置：

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

点击“保存”安装 MCP 服务器

工具文档

网络搜索
- 跨多个引擎执行元搜索
- 输入：
  - query （字符串）：搜索词
  - page （数字，可选）：页码（默认值：1）
  - language （字符串，可选）：语言代码（例如，“en”，“all”，默认值：“all”）
  - categories （数组，可选）：搜索类别（默认值：['general']）
    - 可用：“一般”、“新闻”、“科学”、“文件”、“图像”、“视频”、“音乐”、“社交媒体”、“它”
  - 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

执照

此 MCP 服务器采用 MIT 许可证。详情请参阅许可证文件。

先决条件

您需要运行一个本地 SearXNG 实例。设置方法如下：

使用 Docker 运行 SearXNG

快速入门

# Create config directory
mkdir -p searxng

# Create config file
tee searxng/settings.yml << EOF
use_default_settings: true

server:
  bind_address: "0.0.0.0"
  secret_key: "CHANGE_THIS_TO_SOMETHING_SECURE"  # Generate a random key
  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

# Start container
docker run -d \
  --name searxng \
  -p 8080:8080 \
  -v "$(pwd)/searxng:/etc/searxng" \
  searxng/searxng

测试搜索功能

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

# Or visit in browser
http://localhost:8080/search?q=test

容器管理

# Stop container
docker stop searxng

# Remove container
docker rm searxng

# View container logs
docker logs searxng

# Enable auto-start on boot
docker update --restart always searxng

--restart always标志可确保：

Docker 守护进程启动时容器自动启动
如果容器崩溃，则会自动重启
容器停止后会自动重启，除非用户明确停止

自定义配置

编辑searxng/settings.yml如下：

修改搜索引擎列表
调整安全设置
配置 UI 语言
更改 API 限制

有关详细配置选项，请参阅SearXNG 文档

环境变量

SEARXNG_INSTANCES ：以逗号分隔的 SearXNG 实例 URL 列表默认值： http://localhost:8080
SEARXNG_USER_AGENT ：请求的自定义 User-Agent 标头默认值： MCP-SearXNG/1.0
NODE_TLS_REJECT_UNAUTHORIZED ：设置为“0”以绕过 SSL 证书验证（用于使用自签名证书的开发）默认值：未定义（启用 SSL 验证）

包含所有选项的示例配置：

{
  "mcpServers": {
    "searxng": {
      "name": "searxng",
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ],
      "env": {
        "SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com",
        "SEARXNG_USER_AGENT": "CustomBot/1.0",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

⚠️ 警告：不建议在生产环境中禁用 SSL 证书验证。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

web_search

该服务器通过集成多个搜索引擎（无需跟踪或用户分析）提供以隐私为中心的元搜索功能，支持各种类别和语言的过滤搜索。

Related Resources

Reddit Discussion about this server

SearXNG MCP Server