Skip to main content
Glama
MCP-Undetected-Chromedriver

MCP-Undetected-Chromedriver

by dragons96

MCP 検出されない Chrome ドライバー

鍛冶屋のバッジ

undetected-chromedriver 上に構築された MCP サービス。ボット検出をバイパスしながら Chrome ブラウザの制御を自動化するための包括的なインターフェースを提供します。

中国語の文書

インストール

Smithery経由で Claude Desktop 用の MCP-Undetected-Chromedriver を自動的にインストールするには:

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

Related MCP server: web-scraper-server

検出されないChromedriverサーバーを使用するための設定

Undetected-chromedriver サーバーを使用するための Claude Desktop の構成は次のとおりです。

{
  "mcpServers": {
    "mcp-undetected-chromedriver": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@dragons96/mcp-undetected-chromedriver",
        "--config",
        "{}"
      ]
    }
  }
}

要件

  • Python >= 3.11

  • Chromeブラウザ

UVによる設置

# Create virtual environment
uv venv

# Activate virtual environment
# Windows
.venv\Scripts\activate
# Linux/MacOS
source .venv/bin/activate

# Install dependencies
uv pip install -e .

プロジェクト紹介

MCP-Undetected-Chromedriverは、undetected-chromedriverライブラリの機能を一連の使いやすいAPIにラップしたMCP(マルチチャネルプロトコル)サービスです。このプロジェクトは、自動テスト、データスクレイピング、またはWeb自動化スクリプトにおいて、最新のウェブサイトアンチボット検出メカニズムをバイパスする必要があるシナリオに特に適しています。

主な特徴

  • 検出されないクロームドライバーに基づいており、ウェブサイトのボット対策検出を効果的に回避します

  • 豊富なブラウザ操作APIインターフェースを提供

  • スクリーンショット、PDFエクスポート、その他の機能をサポート

  • クリック、フォームの入力、ドラッグなどの複雑なページインタラクション操作をサポートします。

  • MCPエコシステム内の他のツールとシームレスに統合

ToDoリスト

  • [ ] ブラウザドライバ管理を最適化し、ドライバの中断を処理する

  • [ ] API機能の拡張

  • [ ] より包括的なエラー処理とログ記録を追加

  • [ ] 使用例を増やしてドキュメントを改善する

  • [ ] ブラウザプロファイルと拡張機能のサポートを追加

使用法

サービスの開始

mcp-server-undetected-chromedriver

利用可能なAPI

このサービスは、次の主要な API インターフェースを提供します。

  • browser_navigate : 指定されたURLに移動する

  • browser_screenshot : 現在のページのスクリーンショットを撮ります

  • browser_click : ページ要素をクリック

  • browser_iframe_click : iframe内の要素をクリックする

  • browser_fill : 入力フィールドにコンテンツを入力します

  • browser_select : ドロップダウン選択ボックスでオプションを選択します

  • browser_hover : 要素の上にマウスを移動します

  • browser_evalute : JavaScriptコードを実行する

  • browser_close : ブラウザを閉じる

  • browser_get_visible_text : ページ上の表示テキストを取得する

  • browser_get_visible_html : ページ上の表示可能な HTML を取得する

  • browser_go_back : ブラウザの履歴を前へ戻る

  • browser_go_forward : ブラウザ履歴を進む

  • browser_drag : 要素をドラッグする

  • browser_press_key : キーの押下をシミュレートする

  • browser_save_as_pdf : ページをPDFとして保存する

コード例

from mcp.client import Client

# Create MCP client
client = Client()
client.start("undetected-chromedriver-mcp-server")

# Navigate to website
response = client.call("browser_navigate", {"url": "https://example.com"})
print(response)

# Take a screenshot
response = client.call("browser_screenshot", {"name": "example"})
print(response)

# Get page text
response = client.call("browser_get_visible_text")
print(response.content[0].text)

# Close the browser
client.call("browser_close")

仕組み

このサービスは、undetected-chromedriverライブラリを使用して、一般的なアンチボット検出メカニズムを効果的に回避する特殊なChromeブラウザインスタンスを作成します。これらの機能はMCPプロトコルでラップされており、自動テストやウェブスクレイピングをより便利にする使いやすいAPIインターフェースを提供します。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

寄稿ガイドライン

バグ報告や機能リクエストはGitHubのIssuesページで歓迎いたします。コードを投稿したい場合は、まずIssueを作成してアイデアを議論してください。

よくある質問

Q: 標準の Selenium Web ドライバーではなく、undetected-chromedriver を選択するのはなぜですか?

A: undetected-chromedriver は、Cloudflare、Distil Networks などの最新の Web サイトのボット対策検出メカニズムを回避するように特別に設計されており、データ スクレイピングや自動テストのシナリオでより信頼性が高くなります。

Q: サービスはブラウザインスタンスをどのように処理しますか?

A: このサービスはグローバルブラウザインスタンスを保持しており、ブラウザを必要とするAPIが初めて呼び出されたときに自動的に作成されます。ブラウザはbrowser_close APIを使用して明示的に閉じることができます。

Q: iframe 内の要素をどのように処理しますか?

A: browser_iframe_click API は、フレーム コンテキストを手動で切り替える必要がなく、iframe 内の要素を直接操作できます。

Available Tools

16 tools
browser_clickC

Click an element on the page

Args:
    selector: The selector of the element to click - required

Inputs: selector (required).

browser_closeA

Close the browser and release all resources

Inputs: no named parameters.

browser_dragC

Drag an element to another element

Args:
    sourceSelector: The selector for the element to drag - required
    targetSelector: The selector for the target location - required

Inputs: sourceSelector (required), targetSelector (required).

browser_evaluteC

Evaluate a JavaScript expression in the browser console

Args:
    script: The JavaScript expression to evaluate - required

Inputs: script (required).

browser_fillC

fill out an input field

Args:
    selector: CSS selector for input field - required
    value: The value to fill - required

Inputs: selector (required), value (required).

browser_get_visible_htmlB

Get the HTML of the current page

Inputs: no named parameters.

browser_get_visible_textB

Get the visible text of the current page

Inputs: no named parameters.

browser_go_backA

Navigate back in browser history

Inputs: no named parameters.

browser_go_forwardB

Navigate forward in browser history

Inputs: no named parameters.

browser_hoverC

Hover over an element on the page

Args:
    selector: CSS selector for element to hover over - required

Inputs: selector (required).

browser_iframe_clickB

Click an element inside an iframe on the page

Args:
    iframeSelector: The selector of the iframe - required
    selector: The selector of the element to click - required

Inputs: iframeSelector (required), selector (required).

browser_navigateC

Navigate to a URL

Args:
    url: The URL to navigate to - required
    timeout: The timeout for the navigation - optional, default is 30000

Inputs: url (required), timeout.

browser_press_keyB

Press a key on the keyboard

Args:
    key: The key to press - required, (e.g. 'Enter', 'ArrowDown', 'a')
    selector: Optional CSS selector to focus on before pressing the key - optional

Inputs: key (required), selector.

browser_save_as_pdfB

Save the current page as a PDF

Args:
    outputPath: The path to save the PDF to - required
    filename: The name of the PDF file - optional, default is "page.pdf"
    format: The format of the PDF - optional, default is "A4" (e.g. "A4", "LETTER", "LEGAL", "TABLOID")
    printBackground: Whether to print the background - optional, default is True
    margin: The margin of the PDF - optional, default is None (e.g. {"top": "1cm", "right": "1cm", "bottom": "1cm", "left": "1cm"})

Inputs: outputPath (required), filename, format, margin, +1 more.

browser_screenshotC

Take a screenshot of the current page or a specific element

Args:
    name: The name of the screenshot - required, default is "screenshot"
    storeBase64: Whether to store the screenshot as a base64 string - optional, default is True
    downloadsDir: The directory to save the screenshot to - optional, default is the user's Downloads directory

Inputs: name (required), downloadsDir, storeBase64.

browser_selectC

Select an element on the page with Select tag

Args:
    selector: CSS selector for element to select - required
    value: The value to select - required

Inputs: selector (required), value (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific browser automation tasks like navigation, interaction, and content extraction. However, some overlap exists between browser_click and browser_iframe_click, where the latter is essentially a specialized version of the former for iframes, which could cause minor confusion.

    Naming Consistency5/5

    All tools follow a consistent snake_case naming pattern with a clear 'browser_' prefix followed by a verb_noun structure (e.g., browser_click, browser_navigate, browser_screenshot). This uniformity makes the tool set predictable and easy to understand.

    Tool Count4/5

    With 16 tools, the count is slightly high but reasonable for a browser automation server, covering a wide range of common web interaction tasks. It might feel a bit heavy, but each tool appears to serve a specific function without obvious redundancy.

    Completeness4/5

    The tool set provides comprehensive coverage for core browser automation, including navigation, clicking, typing, hovering, and content extraction. Minor gaps exist, such as no explicit tool for handling cookies, managing tabs, or waiting for elements, but agents can likely work around these using existing tools like browser_evalute or timeouts.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server for stealth browser automation that uses human-like interaction patterns to bypass bot detection via the Chrome DevTools Protocol. It enables users to navigate, interact with elements, and capture data from websites using undetectable behaviors like Bezier mouse movements and Gaussian typing delays.
      2
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Provides browser automation and web scraping as MCP tools, enabling autonomous URL ingestion, crawling, extraction, and anti-bot handling with interactive browser control.
      62
      6
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      MCP server for agent-piloted browser automation that clears Cloudflare, providing multi-session parallel Chromes, persistent profiles, stealth features, credential vault, and vision-first clicking.
      89
      40 PyPI
      9
      Apache 2.0