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

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

インストール

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

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

検出されない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 内の要素を直接操作できます。

MCP-Undetected-Chromedriver

Integrations