MCP Web Search

🚀 網絡搜索 MCP 服務器

本項目是一個 MCP 服務器，提供 Google 搜索功能和網頁內容查看服務，同時具備強大的高級反爬蟲機制，有效保障搜索和內容查看的穩定與安全。

🚀 快速開始

在開始使用本項目前，你需要滿足以下先決條件：

• Bun 運行時環境 v1.0 或更高版本
• Google API 憑證（API Key 和搜索應用 ID）

✨ 主要特性

• Google 自定義搜索：支持高級過濾，可精準定位所需信息。
• 網頁內容查看：帶有 Markdown 轉換功能，方便查看和處理網頁內容。
• 限流與緩存：優化服務器性能，減少不必要的請求。
• 瀏覽器實例池：提高資源利用率，加快搜索和內容查看速度。
• 反爬蟲檢測：使用 rebrowser - puppeteer 技術，有效繞過網站的反爬蟲機制。

📦 安裝指南

# 開發模式運行並監聽文件變化
bun --watch run dev

# 執行測試
bun run test

# 運行代碼檢查
bun run lint

📚 詳細文檔

配置指南

1. Cookie 設置

為了實現身份驗證，請按照以下步驟配置：

• Windows 系統：將 config-example.json 文件複製到 %APPDATA%\Claude\mcp - clients\web - search 目錄下，並重命名為 config.json。
• Mac/Linux 系統：將文件複製到 ~/.claude/mcp - clients/web - search 並重命名為 config.json。

2. 服務器配置

在 config.json 文件中添加以下內容：

{
  "browserLimits": {
    "globalLimit": 5,
    "requesterLimit": 2
  },
  "proxySettings": {
    "useProxy": true,
    "proxyUrl": "http://your - proxy - server:port",
    "proxyEnabledForDomains": ["example.com", "another - site.com"]
  }
}

日誌配置

# 查看日誌文件
# MacOS/Linux 系統：
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# Windows 系統：
type %APPDATA%\Claude\Logs\mcp*.log

反爬蟲機制說明

• 請求頻率限制：通過 browserLimits 配置控制併發和總請求數量，避免因請求過於頻繁被網站封禁。
• 代理設置：配置 proxySettings 以繞過反爬蟲檢測，支持指定域名使用代理。

工具接口

搜索工具

{
  name: "search",
  params: {
    query: string;          // 必填項：搜索關鍵詞
    trustedDomains?: string[]; // 可選：可信域名列表
    excludedDomains?: string[]; // 可選：排除的域名
    resultCount?: number;   // 可選：返回結果數量，默認為 10
    safeSearch?: boolean;   // 可選：啟用安全搜索，默認為 true
    dateRestrict?: string;  // 可選：時間限制，支持 "d"（過去一天）、"w"（過去一週）等選項
  }
}

網頁查看工具

{
  name: "view_url",
  params: {
    url: string;            // 必填項：目標網頁地址
    includeImages?: boolean; // 可選：是否包含圖片，默認為 true
    includeVideos?: boolean; // 可選：是否包含視頻，默認為 true
    preserveLinks?: boolean; // 可選：保持鏈接完整性，默認為 true
    formatCode?: boolean;   // 可選：格式化代碼輸出，默認為 false
  }
}

注意事項

⚠️ 重要提示

• 服務器內置了多種反爬蟲機制，但仍需結合代理和用戶代理設置以增強安全性。
• 部分網站可能仍能檢測到自動化行為。

💡 使用建議

• 瀏覽器實例池化設計可提高資源利用率。
• 智能清理空閒瀏覽器以避免資源耗盡。

📄 許可證

本項目遵循 MIT 開源協議，具體條款請參考 LICENSE 文件。