MCP-Undetected-Chromedriver
MCP 検出されない Chrome ドライバー
undetected-chromedriver 上に構築された MCP サービス。ボット検出をバイパスしながら Chrome ブラウザの制御を自動化するための包括的なインターフェースを提供します。
インストール
Smithery経由で Claude Desktop 用の MCP-Undetected-Chromedriver を自動的にインストールするには:
npx -y @smithery/cli install @dragons96/mcp-undetected-chromedriver --client claudeRelated 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 toolsbrowser_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_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
Scored across 16 tools
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.
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.
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.
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
Related MCP Connectors
Browser automation MCP for whole web tasks in a cloud browser: saved logins, bot checks, replays.
Crawl, scrape, search the web, and automate browsers at scale with anti-bot bypass.
Web scraping MCP server — scrape, extract structured data, screenshot any site with anti-bot bypass.
Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn 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.2MIT
- AlicenseCqualityDmaintenanceProvides browser automation and web scraping as MCP tools, enabling autonomous URL ingestion, crawling, extraction, and anti-bot handling with interactive browser control.626MIT
- FlicenseCqualityDmaintenanceEnables browser automation, including navigation, form filling, login with CAPTCHA handling, and element manipulation, using a Chrome-based MCP server.364-
- AlicenseCqualityBmaintenanceMCP server for agent-piloted browser automation that clears Cloudflare, providing multi-session parallel Chromes, persistent profiles, stealth features, credential vault, and vision-first clicking.8940 PyPI9Apache 2.0