Searxng MCP Server

🚀 SearXNG MCP 服務器

SearXNG MCP 服務器為用戶提供了便捷的搜索服務，支持多種安裝方式和配置選項，還能與不同客戶端集成，滿足多樣化的使用需求。

🚀 快速開始

SearXNG MCP 服務器可通過 Docker 或本地環境進行安裝，安裝完成後，根據需求配置相關參數，即可與客戶端集成使用。

📦 安裝指南

環境要求

• Python 3.8 或更高版本
• Docker（可選）

安裝方法

1. 使用 Docker 安裝：

docker run -d --name searxng-mcp-server -p 32769:32769 mcp/searxng-mcp-server

2. 本地安裝：

git clone https://github.com/your-repository.git
cd searxng-mcp-server
pip install -r requirements.txt
python server.py

📚 詳細文檔

配置參數

網絡配置

• HOST：服務器綁定的地址，默認為 0.0.0.0
• PORT：服務器監聽的端口，默認為 32769

SearXNG 配置

• SEARXNG_BASE_URL：SearXNG 的基礎 URL，例如 http://localhost:32768

日誌配置

• LOG_LEVEL：日誌級別，可選值為 debug、info、warning、error、critical，默認為 info
• LOG_FILE：日誌文件路徑，默認為 ./mcp_server.log

與客戶端集成

使用 Windsurf 配置

在你的配置文件中添加以下內容：

{
  "mcpServers": {
    "searxng": {
      "transport": "sse",
      "serverUrl": "http://host.docker.internal:32769/sse"
    }
  }
}

使用 n8n 配置

在你的節點配置中設置：

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
               "-e", "TRANSPORT=stdio",
               "-e", "SEARXNG_BASE_URL=http://localhost:32768",
               "mcp/searxng-mcp-server"],
      "env": {
        "PORT": "32769"
      }
    }
  }
}

自定義服務器擴展

添加自定義工具

通過 @mcp.tool() 裝飾器創建自定義工具方法。

配置生命週期函數

在 server.py 中添加：

def lifespan(app: FastAPI):
    # 初始化數據庫連接或其他依賴項
    return {"startup": None, "shutdown": None}

SearXNG 搜索參數

• q：必填，搜索查詢字符串。
• categories：激活的搜索分類，逗號分隔。
• engines：激活的搜索引擎，逗號分隔。
• 其他高級參數如語言、頁面數等，請參考 SearXNG 文檔。

📄 許可證

本項目採用 MIT License 開源協議。