Puppeteer MCP サーバー

Puppeteer MCP サーバー (Python 実装)

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

概要

このPython実装は、TypeScript版の安定した代替手段であり、エラー処理とログ出力が改善された上でTypeScript版と同等の機能を提供します。PuppeteerのPython版であるPlaywrightを使用し、堅牢なブラウザ自動化機能を提供します。

主な特徴

完全なブラウザ自動化
ページナビゲーション
スクリーンショットキャプチャ（ページ全体または要素）
フォームインタラクション（クリックと入力）
JavaScript実行
コンソールログ監視
設定可能なタイムアウト
詳細なエラー処理
包括的なログ記録

前提条件

Python 3.8以上
pip (Python パッケージインストーラー)

インストール

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

pip install -r requirements.txt

Playwright ブラウザをインストールします。

playwright install

使用法

サーバーの起動

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

python puppeteer_server.py

クロードデスクトップ構成

Claude 構成ファイルに以下を追加します。

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

利用可能なツール

操り人形師ナビゲート

ブラウザで任意の URL に移動します。

{
  "name": "puppeteer_navigate",
  "arguments": {
    "url": "https://example.com",
    "timeout": 60000  // optional, defaults to 60000ms
  }
}

操り人形師のスクリーンショット

ページ全体または特定の要素のスクリーンショットをキャプチャします。

{
  "name": "puppeteer_screenshot",
  "arguments": {
    "name": "my_screenshot",
    "selector": "#specific-element",  // optional
    "width": 1280,  // optional, default: 1280
    "height": 720,  // optional, default: 720
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

操り人形師クリック

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

{
  "name": "puppeteer_click",
  "arguments": {
    "selector": ".button-class",
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

操り人形師の塗りつぶし

入力フィールドに入力します。

{
  "name": "puppeteer_fill",
  "arguments": {
    "selector": "#input-id",
    "value": "text to fill",
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

操り人形師の評価

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

{
  "name": "puppeteer_evaluate",
  "arguments": {
    "script": "document.title",
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

エラー処理

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

ナビゲーションの失敗
要素が見つかりません
タイムアウトエラー
JavaScript実行エラー
スクリーンショットの失敗

ログ記録

包括的なログ記録はさまざまなレベルで実装されています。

情報: 標準操作
エラー: 操作失敗
DEBUG: 詳細な実行情報

注記

デバッグを向上させるために、ブラウザは非ヘッドレスモードで起動します
デフォルトのビューポートサイズは1280x720です
すべてのタイムアウトは設定可能
コンソールログがキャプチャされ保存されます
スクリーンショットはbase64エンコードでメモリに保存されます

貢献

貢献を歓迎します。プルリクエストを送信する前に、リポジトリの貢献ガイドラインをお読みください。

ライセンス

このプロジェクトは、Apache 2.0 ライセンスに基づいてライセンスされています。詳細については、LICENSE ファイルを参照してください。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Playwright を使用してブラウザ自動化機能を提供するモデルコンテキストプロトコルサーバー。LLM が Web ページを操作したり、スクリーンショットを撮ったり、実際のブラウザ環境で JavaScript を実行したりできるようになります。

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-playwright
executeautomation
A
security
A
license
A
quality
A Model Context Protocol server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
Last updated -
13
9,457
3,642
TypeScript
MIT License
Playwright MCP Server
lebrodus
A
security
F
license
A
quality
A server that enables browser automation using Playwright, allowing interaction with web pages, capturing screenshots, and executing JavaScript in a browser environment through LLMs.
Last updated -
12
9,457
1
TypeScript
BrowserCat MCP Server (Browser Automation)official
browsercat
-
security
F
license
-
quality
A Model Context Protocol server that provides browser automation capabilities using BrowserCat's cloud browser service. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment without needing to install browsers locally.
Last updated -
39
Puppeteer MCP Server
cploujoux
-
security
F
license
-
quality
A Model Context Protocol server that provides browser automation capabilities using Puppeteer, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
Last updated -
15,502
JavaScript

View all related MCP servers

Puppeteer MCP Server