Kevinwatt MCP Server Searxng

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