Puppeteer

Puppeteer

Puppeteer を使用してブラウザー自動化機能を提供する Model Context Protocol サーバーです。このサーバーにより、LLM はウェブページを操作し、スクリーンショットを撮影し、実際のブラウザー環境で JavaScript を実行できます。

コンポーネント

ツール

• puppeteer_navigate

  • ブラウザーで任意の URL に移動します
  • 入力：url（string）

• puppeteer_screenshot

  • ページ全体または特定の要素のスクリーンショットを撮影します
  • 入力：
    • name（string、必須）：スクリーンショットの名前
    • selector（string、任意）：スクリーンショットを撮影する要素の CSS セレクター
    • width（number、任意、デフォルト：800）：スクリーンショットの幅
    • height（number、任意、デフォルト：600）：スクリーンショットの高さ

• puppeteer_click

  • ページ上の要素をクリックします
  • 入力：selector（string）：クリックする要素の CSS セレクター

• puppeteer_hover

  • ページ上の要素にカーソルを合わせます
  • 入力：selector（string）：カーソルを合わせる要素の CSS セレクター

• puppeteer_fill

  • 入力フィールドに値を入力します
  • 入力：
    • selector（string）：入力フィールドの CSS セレクター
    • value（string）：入力する値

• puppeteer_select

  • SELECT タグの要素を選択します
  • 入力：
    • selector（string）：選択する要素の CSS セレクター
    • value（string）：選択する値

• puppeteer_evaluate

  • ブラウザーのコンソールで JavaScript を実行します
  • 入力：script（string）：実行する JavaScript コード

リソース

サーバーは次の 2 種類のリソースを提供します。

1. コンソールログ（console://logs）

   • ブラウザーのコンソール出力をテキスト形式で提供します
   • ブラウザーからのすべてのコンソールメッセージが含まれます

2. スクリーンショット（screenshot://<name>）

   • 撮影したスクリーンショットの PNG 画像です
   • 撮影時に指定したスクリーンショット名でアクセスできます

主な機能

• ブラウザー自動化
• コンソールログの監視
• スクリーンショット機能
• JavaScript の実行
• 基本的なウェブ操作（移動、クリック、フォームへの入力）

Puppeteer サーバーを使用するための設定

Puppeter サーバーを使用するための Claude Desktop の設定を以下に示します。

Docker

注意 Docker の実装ではヘッドレス Chromium が使用されますが、NPX 版ではブラウザーウィンドウが開きます。

{
  "mcpServers": {
    "puppeteer": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "mcp/puppeteer"]
    }
  }
}

NPX

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

ビルド

Docker のビルド：

docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。