Puppeteer MCP サーバー (Python 実装)
Playwright（Python版Puppeteer）を用いたブラウザ自動化機能を提供するモデルコンテキストプロトコル（LLM）サーバー。このサーバーにより、LLMはWebページとのインタラクション、スクリーンショットの取得、そして実際のブラウザ環境でのJavaScript実行が可能になります。
概要
このPython実装は、TypeScript版の安定した代替手段であり、エラー処理とログ出力が改善された上でTypeScript版と同等の機能を提供します。PuppeteerのPython版であるPlaywrightを使用し、堅牢なブラウザ自動化機能を提供します。
Related MCP server: Playwright MCP Server
主な特徴
完全なブラウザ自動化
ページナビゲーション
スクリーンショットキャプチャ（ページ全体または要素）
フォームインタラクション（クリックと入力）
JavaScript実行
コンソールログ監視
設定可能なタイムアウト
詳細なエラー処理
包括的なログ記録
前提条件
Python 3.8以上
pip (Python パッケージインストーラー)
インストール
必要なパッケージをインストールします。
Playwright ブラウザをインストールします。
使用法
サーバーの起動
サーバーを直接実行します。
クロードデスクトップ構成
Claude 構成ファイルに以下を追加します。
利用可能なツール
操り人形師ナビゲート
ブラウザで任意の URL に移動します。
操り人形師のスクリーンショット
ページ全体または特定の要素のスクリーンショットをキャプチャします。
操り人形師クリック
ページ上の要素をクリックします。
操り人形師の塗りつぶし
入力フィールドに入力します。
操り人形師の評価
ブラウザコンソールで JavaScript を実行します。
エラー処理
サーバーは、一般的なシナリオに対して詳細なエラー メッセージを提供します。
ナビゲーションの失敗
要素が見つかりません
タイムアウトエラー
JavaScript実行エラー
スクリーンショットの失敗
ログ記録
包括的なログ記録はさまざまなレベルで実装されています。
情報: 標準操作
エラー: 操作失敗
DEBUG: 詳細な実行情報
注記
デバッグを向上させるために、ブラウザは非ヘッドレスモードで起動します
デフォルトのビューポートサイズは1280x720です
すべてのタイムアウトは設定可能
コンソールログがキャプチャされ保存されます
スクリーンショットはbase64エンコードでメモリに保存されます
貢献
貢献を歓迎します。プルリクエストを送信する前に、リポジトリの貢献ガイドラインをお読みください。
ライセンス
このプロジェクトは、Apache 2.0 ライセンスに基づいてライセンスされています。詳細については、LICENSE ファイルを参照してください。