Searxng Simple MCP

🚀 使用 Searx 搜索引擎與 MCP 協議

Searx 是一款開源的去中心化搜索引擎，支持通過 MCP（機器控制協議）接口進行交互。本文檔將為你詳細指導如何配置並運行 Searx 與 MCP 協議的結合使用。

🚀 快速開始

你可以按照以下步驟，逐步完成 Searx 與 MCP 協議結合使用的配置與運行。

📦 安裝指南

要開始使用，請按照以下步驟安裝必要的工具：

1. Python 環境
   • 安裝 Python （推薦使用版本 3.6 或更高）
   • 安裝 pip：

python get-pip.py

2. 安裝依賴項
   • 使用 pip 安裝項目依賴：

pip install -r requirements.txt

📚 詳細文檔

配置

在 config.yml 文件中進行以下配置：

# MCP 服務器設置
mcp:
  server: searx
  host: "0.0.0.0"
  port: 8080
  timeout: 10
  max_results: 20
  language: all

# Searx 設置
searx:
  instance_name: "My Searx Instance"
  bind_interface: "0.0.0.0"
  port: 8081
  debug_mode: false

運行

使用 Docker

快速運行（無安裝）

直接使用以下命令運行：

docker run -d --name searx-mcp -p 8080:8080 -p 8081:8081 searx/mcp-server

使用 Docker Compose

創建 docker-compose.yml 文件並添加以下內容：

version: '3'
services:
  searx-mcp:
    image: searx/mcp-server
    ports:
      - "8080:8080"
      - "8081:8081"

然後運行：

docker-compose up --detach

自定義配置

通過設置環境變量來調整行為：

• SEARX_MCP_HOST：指定 MCP 服務器的主機地址，默認為 0.0.0.0
• SEARX_MCP_PORT：指定 MCP 服務器的端口，默認為 8080
• SEARX_SEARCH_PORT：指定 Searx 搜索引擎的端口，默認為 8081

💻 使用示例

基礎用法

查詢示例

發送一個簡單的搜索請求：

curl -X POST http://localhost:8080/mcp/search \
  -H "Content-Type: application/json" \
  -d '{"query":"機器學習","language":"all"}'

配置 MCP 客戶端

在 MCP 客戶端中添加 Searx 服務器的配置：

{
  "mcpServers": {
    "searx": {
      "url": "http://localhost:8080",
      "transport": "stdio"
    }
  }
}

🔧 技術細節

開發

安裝開發依賴

npm install -D devDependencies

運行調試

npm run dev

打包發佈

npm run build

📄 許可證

本項目遵循 MIT 許可證。有關詳細信息，請參閱 LICENSE 文件。