MCP Server Serper

🚀 使用Serper搜索和抓取MCP服務器

一個基於TypeScript的MCP服務器，使用Serper API提供網絡搜索和網頁抓取功能。此服務器與Claude Desktop集成，能夠實現強大的網絡搜索和內容提取功能。

✨ 主要特性

工具

• google_search - 通過Serper API執行網絡搜索

  • 豐富的搜索結果，涵蓋有機結果、知識圖譜、“人們也問”和相關搜索。
  • 支持區域和語言定位。
  • 可選參數眾多，包括位置、分頁、時間過濾器和自動更正。
  • 支持高級搜索運算符：
    • site：將搜索結果限制到特定域名。
    • filetype：將結果限制為特定文件類型（例如'pdf'，'doc'）。
    • inurl：搜索URL中包含指定單詞的頁面。
    • intitle：搜索標題中包含指定單詞的頁面。
    • related：查找類似網站。
    • cache：查看Google緩存中的特定URL版本。
    • before：以YYYY - MM - DD格式，獲取指定日期之前的結果。
    • after：以YYYY - MM - DD格式，獲取指定日期之後的結果。
    • exact：精確短語匹配。
    • exclude：從搜索結果中排除特定術語。
    • or：替代詞（OR運算符）。

• scrape - 從網頁提取內容

  • 可獲取純文本和可選Markdown格式的內容。
  • 包含JSON - LD和頭部元數據。
  • 支持Cookie和JavaScript渲染。

📦 安裝指南

要求

• Node.js版本：14.19.1或更高。
• 必須設置環境變量SERPER_API_KEY，獲取方式請參考官方網站。

安裝與運行

安裝依賴

npm install

構建項目

npm run build

啟動服務器

npm start

其他安裝方式

通過Smithery CLI

npx serper create@mcp-server-serper mcp-server
cd mcp-server
npm install

Claude Desktop配置

方式一：直接運行命令

env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

方式二：創建自定義啟動項

• 名稱：可任意命名。
• 命令：env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

Cline配置

在Cline的“MCP服務器”部分，添加新的服務器：

• 選擇“命令”類型。
• 在“命令”字段中輸入以下內容：

env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

Docker運行

構建鏡像

docker build -t mcp-server-serper .

啟動容器

docker run -e SERPER_API_KEY=your_api_key_here mcp-server-serper

使用.env文件

docker run --env-file .env mcp-server-serper

開發環境掛載

docker run -v $(pwd):/app --env-file .env mcp-server-serper

⚠️ 重要提示

請將your_api_key_here替換為實際的Serper API密鑰。

💡 使用建議

如果遇到問題，請檢查以下日誌：

• src/utils/logger.ts - 記錄基礎信息。
• src/utils/selenium_logger.ts - 記錄瀏覽器操作日誌。
• 如果需要調試JavaScript渲染的問題，可以嘗試降低Puppeteer的內存限制：

npm run dev --args=--memory=1024MB