MCP Searxng 1g0

🚀 mcp-searxng

mcp-searxng 是一個基於 SSE（Server-Sent Events）協議實現的 MCP 服務器。它藉助 SearXNG 搜索引擎，為用戶提供網頁搜索和內容抓取功能。用戶還能通過配置不同的搜索引擎 URL 來拓展搜索能力。

🚀 快速開始

項目結構

mcp-searxng/
├── server.py             # 基於 SSE 協議的 MCP 服務器實現
├── Dockerfile           # 項目的 Docker 配置文件
└── README.md            # 項目文檔

安裝依賴

1. 安裝 Python 環境：

python -m pip install --upgrade pip
pip install "uvicorn>=0.25.0"
pip install "httpx>=0.26.0"

2. 安裝 Node.js 和 npm：

# 下載並安裝 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash

# 在 shell 中加載 nvm：
source ~/.nvm/nvm.sh

# 安裝 Node.js 版本 22：
nvm install 22

# 驗證 Node.js 和 npm 是否安裝成功：
node -v # 應輸出 "v22.14.0"
npm -v # 應輸出 "10.9.2"

運行項目

1. 使用 Docker 啟動 MCP 服務器：

docker build -t mcp-searxng .
docker run -d --env SEARXNG_URL=http://localhost:8888 -p 5488:5488 mcp-searxng

2. 使用命令行直接運行：

uvicorn server:app --host 0.0.0.0 --port 5488

驗證結果

1. 安裝並啟動 MCP Inspector：

npx @modelcontextprotocol/inspector

# 打開瀏覽器訪問 http://localhost:5173

2. 在 MCP Inspector 中進行以下操作：
   • 選擇 SSE 作為傳輸類型
   • 輸入 MCP 服務器地址：http://localhost:5488/sse
   • 點擊連接，驗證是否成功連接
   • 切換到工具標籤頁，點擊“List Tools”按鈕，查看可用工具：
     • web_search：用於關鍵詞搜索
     • web_url_read：用於網頁內容抓取

✨ 主要特性

• 基於 SSE 協議實現長連接通信
• 支持通過 SearXNG 引擎進行關鍵詞搜索
• 提供網頁內容抓取功能
• 支持自定義 SearXNG 服務地址

🔧 技術細節

為什麼選擇 SSE

SSE（Server-Sent Events）協議是一種允許服務器向客戶端推送即時事件的技術。相比傳統的輪詢機制，SSE 具有以下優勢：

1. 長連接支持：每個客戶端連接可以保持較長時間，減少資源消耗
2. 即時更新：服務器可以即時推送數據到客戶端
3. 低延遲：數據傳輸更快，適合需要即時響應的場景

MCP 服務器配置參數

# server.py 中定義的默認參數
class ServerConfig:
    def __init__(self):
        self.host = "0.0.0.0"
        self.port = 5488
        self.searxng_url = "http://localhost:8888"

# 啟動命令示例：
uvicorn server:app --host <your host> --port <your port>

參數說明

💻 使用示例

基礎用法

# server.py 中的核心實現
from fastapi import FastAPI
from starlette.responses import EventStreamResponse

app = FastAPI()

@app.get("/sse")
async def sse_endpoint():
    return EventStreamResponse()

運行截圖