MCP Server Puppeteer Py

🚀 木偶师 MCP サーバー（Python 実装）

このサーバーは、Playwright（Python 版の Puppeteer）を使用したブラウザ自動化機能を提供するモデルコンテキストプロトコルサーバーです。LLM が実際のブラウザ環境でウェブページとの対話、スクリーンショットの取得、JavaScript の実行を可能にします。

🚀 クイックスタート

この Python 実装は、TypeScript 版と同等の機能を提供しながら、エラー処理とログ記録がより優れている安定した代替案です。Playwright を使用することで、強力なブラウザ自動化機能を提供します。

✨ 主な機能

• ブラウザの完全自動化
• ページナビゲーション
• スクリーンショットの取得（全ページまたは要素）
• フォームの操作（クリックと入力）
• JavaScript の実行
• コンソールログの監視
• タイムアウトの設定可能
• 詳細なエラー処理
• 充実したログ記録

📦 インストール

前提条件

• Python 3.8 以上
• pip（Python パッケージインストーラー）

インストール手順

1. 必要なパッケージをインストールします：

pip install -r requirements.txt

2. Playwright のブラウザをインストールします：

playwright install

💻 使用例

サーバーの起動

サーバーを直接実行します：

python puppeteer_server.py

Claude デスクトップの設定

Claude の設定ファイルに以下の内容を追加します：

{
  "mcpServers": {
    "puppeteer": {
      "command": "python",
      "args": ["path/to/puppeteer.py"]
    }
  }
}

利用可能なツール

基本的な使用法

puppeteer_navigate

任意の URL に移動します。

{
  "name": "puppeteer_navigate",
  "arguments": {
    "url": "https://example.com",
    "timeout": 60000  // オプション、デフォルトは 60000ms
  }
}

puppeteer_screenshot

ウェブページまたは特定の要素のスクリーンショットを取得します。

{
  "name": "puppeteer_screenshot",
  "arguments": {
    "name": "my_screenshot",
    "selector": "#specific-element",  // オプション
    "width": 1280,  // オプション、デフォルト：1280
    "height": 720,  // オプション、デフォルト：720
    "timeout": 30000  // オプション、デフォルトは 30000ms
  }
}

puppeteer_click

ページ上の要素をクリックします。

{
  "name": "puppeteer_click",
  "arguments": {
    "selector": ".button-class",
    "timeout": 30000  // オプション、デフォルトは 30000ms
  }
}

puppeteer_fill

入力フィールドにテキストを入力します。

{
  "name": "puppeteer_fill",
  "arguments": {
    "selector": "#input-id",
    "value": "要填充的文本",
    "timeout": 30000  // オプション、デフォルトは 30000ms
  }
}

puppeteer_evaluate

ブラウザコンソールで JavaScript を実行します。

{
  "name": "puppeteer_evaluate",
  "arguments": {
    "script": "document.title",
    "timeout": 30000  // オプション、デフォルトは 30000ms
  }
}

🔧 技術詳細

エラー処理

サーバーは、以下のような状況で詳細なエラーメッセージを提供します：

• ナビゲーションの失敗
• 要素が見つからない
• タイムアウトエラー

ログ記録

ログは 3 つのレベルに分けられます：

• INFO：通常の操作メッセージ
• ERROR：エラーまたは例外の状況
• DEBUG：詳細なデバッグ情報

デフォルトでは、ブラウザは非ヘッドレスモードで実行され、デバッグに便利です。本番環境では、パフォーマンス向上のためにヘッドレスモードに切り替える必要があるかもしれません。

タイムアウトの設定

ネットワーク遅延やその他の問題によるスクリプトの固まりを避けるため、待機時間を具体的なニーズに合わせて調整することができます。

このプロジェクトは、ブラウザ自動化タスクが必要な開発者に適した充実した機能と良いドキュメントを提供しています。特に Playwright のサポートにより、Python 環境でも効率的なウェブページ操作が可能です。