Kevinwatt MCP Server Searxng

🚀 SearXNG MCP 服务器

SearXNG MCP 服务器是一个集成到 SearXNG 的 MCP 服务器实现，它提供了隐私导向的元搜索功能，能结合多个搜索引擎的结果，为用户带来更全面、安全的搜索体验。

🚀 快速开始

若要使用 SearXNG MCP 服务器，你需要一个本地运行的 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

✨ 主要特性

• 元搜索：结合多个搜索引擎的结果，让搜索结果更全面。
• 隐私导向：无跟踪，无用户画像，充分保护用户隐私。
• 多类别支持：支持通用、新闻、科学、文件、图片、视频等多种搜索类别。
• 语言支持：可以指定语言搜索，也支持搜索所有语言的内容。
• 时间范围过滤：可按天、周、月、年筛选搜索结果。
• 安全搜索：提供三个级别的安全搜索过滤（无、中等、严格）。
• 备用支持：多个 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

配置文件说明

• 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 文件。