Undetected ChromeDriver

🚀 MCP-未被檢測到的ChromeDriver

一個基於undetected-chromedriver構建的MCP服務，提供全面的瀏覽器控制接口，可用於自動化Chrome瀏覽器操作，還能繞過反-bot檢測機制，適用於數據抓取和自動化測試等場景。

中文文檔

🚀 快速開始

MCP-未被檢測到的ChromeDriver是一個基於undetected-chromedriver構建的MCP服務，提供全面的瀏覽器控制接口。該服務旨在繞過現代網站（如Cloudflare、Distil Networks等）的反-bot檢測機制，適用於數據抓取和自動化測試場景。

✨ 主要特性

• 基於undetected-chromedriver構建，可繞過現代網站的反-bot檢測機制。
• 提供全面的瀏覽器控制接口，簡化瀏覽器操作流程。
• 適用於數據抓取和自動化測試等場景。

📦 安裝指南

通過Smithery自動安裝

通過Smithery自動安裝MCP-未被檢測到的ChromeDriver以供Claude Desktop使用：

npx -y @smithery/cli install @dragons96/mcp-undetected-chromedriver --client claude

常規安裝步驟

使用以下命令安裝：

pip install mcp-wf

創建虛擬環境並激活（可選）：

uv venv
source venv/bin/activate  # 在Windows上運行：.venv\Scripts\activate

配置

在Claude Desktop中配置Undetected Chromedriver服務器，如下所示：

{
  "mcp": {
    "servers": [
      {
        "id": "undetected-chromedriver",
        "url": "http://localhost:9001"
      }
    ],
    "options": {
      "browser": "chrome",
      "serverId": "undetected-chromedriver"
    }
  }
}

要求

• Python版本：Python 3.8或更高
• 瀏覽器：安裝最新版Chrome瀏覽器

💻 使用示例

啟動服務

mcp-wf start

可用API接口

基礎用法

• 導航到指定URL

from mcp import client

cli = client.Client()
cli.navigation.goto("https://example.com")

• 獲取頁面內容

content = cli.executor.execute("return document.body.innerHTML;")
print(content)

• 關閉瀏覽器實例

cli.executor.close()

📚 詳細文檔

工作原理

該服務通過undetected-chromedriver繞過反-bot檢測機制，並利用MCP協議提供一系列API接口，簡化瀏覽器操作流程。

待辦事項

• 支持Firefox瀏覽器
• 實現多線程支持
• 添加日誌記錄功能
• 優化錯誤處理機制

常見問題解答（FAQ）

Q: 為什麼選擇undetected-chromedriver而不是標準的Selenium Webdriver？ A: undetected-chromedriver專為繞過現代網站的反-bot檢測機制而設計，如Cloudflare、Distil Networks等，在數據抓取和自動化測試場景中更為可靠。

Q: 服務如何處理瀏覽器實例？ A: 該服務維護一個全局瀏覽器實例，首次調用需要瀏覽器的操作時會自動創建。您可以使用browser_closeAPI顯式關閉瀏覽器。

Q: 如何處理iframe中的元素？ A: browser_iframe_click API可以直接操作iframe內的元素，無需手動切換幀上下文。

貢獻指南

歡迎提交bug報告和功能請求！如需貢獻代碼，請先與我們討論您的計劃。

📄 許可證

本項目遵循MIT License協議。請查閱LICENSE文件以獲取詳細信息。