Serper Search

🚀 MCP 服務器 Serper

本項目是基於 Python 的 MCP（模型上下文協議）服務器，藉助 API Serper 開展網絡搜索，有效解決信息獲取難題，為用戶提供便捷的網絡搜索服務。

🚀 快速開始

本項目實現了一個遵循 MCP 協議的服務器，具備以下功能：

• 傳輸 Server-Sent Events (SSE)
• 通過 API Serper 實現網絡搜索
• 提取網頁內容
• 服務健康狀態檢查

✨ 主要特性

• SSE 傳輸：支持 Server-Sent Events (SSE) 傳輸，實現服務器與客戶端之間的即時通信。
• 網絡搜索：藉助 API Serper 進行網絡搜索，獲取豐富的網絡信息。
• 內容提取：能夠提取網頁內容，方便用戶獲取所需信息。
• 健康檢查：提供服務健康狀態檢查功能，確保服務的穩定性。

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• Serper API 賬戶（https://serper.dev）

安裝步驟

1. 克隆倉庫：

git clone https://github.com/seu-usuario/mcp-server-serper.git
cd mcp-server-serper

2. 安裝項目：

pip install -e .

💻 使用示例

啟動服務器

mcp-server-serper

或直接通過 Python 運行：

python -m mcp_server_serper.main

連接到服務器

服務器暴露以下端點：

• GET /：顯示基本信息頁面
• GET /sse：用於連接到 MCP 客戶端的 SSE 端點
• POST /messages：接收來自客戶端的消息

可用工具

• google_search：通過 Serper API 實現網絡搜索
• scrape：提取網頁內容
• _health：檢查服務健康狀態

📚 詳細文檔

配置

在項目根目錄下創建一個 .env 文件，包含以下變量：

SERPER_API_KEY=sua_chave_api_serper
MCP_TOKEN=seu_token_autenticacao  # 可選
HOST=127.0.0.1  # 可選，默認：127.0.0.1
PORT=3001  # 可選，默認：3001

🔧 技術細節

開發流程

1. 安裝開發依賴項：

pip install -e ".[dev]"

2. 運行測試：

pytest

3. 檢查代碼質量：

black .
isort .
mypy src
flake8

📄 許可證

該項目根據 MIT 許可證發佈，詳細信息請查看 LICENSE 文件。