Twolven MCP Server Puppeteer Py

🚀 Playwright を使用した Puppeteer MCP サーバー（Python 実装）

大規模言語モデルにブラウザ自動化機能を提供する Model Context Protocol サーバーです。Playwright（Python 版の Puppeteer）を使用しています。このサーバーにより、LLM は実際のブラウザ環境でウェブページとの対話、スクリーンショットの取得、JavaScript の実行が可能になります。

🚀 クイックスタート

この Python 実装は、TypeScript 版と同等の機能を備え、エラー処理とログ記録がより充実した安定した代替手段を提供します。Python 版の Puppeteer である 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
  }
}

高度な使用法

フォームの入力とスクリーンショットの取得

from playwright.sync_playwright import sync_playwright

def main():
    with sync_playwright() as p:
        browser = p.chromium.launch()
        page = browser.new_page()
        
        # ページに移動
        page.goto('https://example.com')
        
        # フォームに入力
        page.fill('#username', 'admin')
        page.fill('#password', 'secret')
        
        # フォームを送信
        page.click('button[type="submit"]')
        
        # スクリーンショットを取得
        page.screenshot(path='screenshot.png', quality=100)
        
        browser.close()

if __name__ == "__main__":
    main()

📚 ドキュメント

エラー処理

サーバーは、一般的なシナリオをカバーする詳細なエラーメッセージを提供します。

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

ログ記録

コンソール出力を通じてデバッグと監視を行い、問題のトラブルシューティングを容易にします。

プロジェクト構造

puppeteer_server/
├── server.py        # メインサーバーファイル
├── utils.py         # ユーティリティ関数
├── requirements.txt # 依存関係管理
└── README.md        # プロジェクトドキュメント

📄 ライセンス

[ここにライセンス情報を挿入]

Puppeteer MCP サーバーをご利用いただき、ありがとうございます！ご質問やフィードバックがある場合は、メンテナンスチームにご連絡ください。