設定可能な Puppeteer MCP サーバー

Puppeteerを用いたブラウザ自動化機能を提供するモデルコンテキストプロトコル（CMP）サーバー。設定可能なオプションを備えています。このサーバーにより、LLMはWebページとのインタラクション、スクリーンショットの取得、実際のブラウザ環境でのJavaScript実行が可能になり、環境変数を介してPuppeteerの起動オプションをカスタマイズできます。

コンポーネント

ツール

• 操り人形師ナビゲート

  • ブラウザで任意のURLに移動する

  • 入力: url (文字列)

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

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

  • 入力:

    • name (文字列、必須): スクリーンショットの名前

    • selector （文字列、オプション）：スクリーンショットを撮る要素のCSSセレクター

    • width （数値、オプション、デフォルト：800）：スクリーンショットの幅

    • height （数値、オプション、デフォルト：600）：スクリーンショットの高さ

• 操り人形師クリック

  • ページ上の要素をクリック

  • 入力: selector (文字列): クリックする要素の CSS セレクター

• 操り人形師_hover

  • ページ上の要素をホバーする

  • 入力: selector (文字列): ホバーする要素の CSS セレクター

• 操り人形師の塗りつぶし

  • 入力フィールドに記入してください

  • 入力:

    • selector （文字列）：入力フィールドのCSSセレクター

    • value (文字列): 入力する値

• 操り人形師の選択

  • SELECTタグで要素を選択する

  • 入力:

    • selector (文字列): 選択する要素の CSS セレクター

    • value (文字列): 選択する値

• 操り人形師の評価

  • ブラウザコンソールでJavaScriptを実行する

  • 入力: script (文字列): 実行するJavaScriptコード

リソース

サーバーは、次の 2 種類のリソースへのアクセスを提供します。

1. コンソールログ( console://logs )

   • ブラウザコンソールのテキスト形式の出力

   • ブラウザからのすべてのコンソールメッセージが含まれます

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

   • キャプチャしたスクリーンショットのPNG画像

   • キャプチャ時に指定したスクリーンショット名からアクセスできます

Related MCP server: Steel Puppeteer

主な特徴

• ブラウザ自動化

• コンソールログ監視

• スクリーンショット機能

• JavaScript実行

• 基本的なウェブインタラクション（ナビゲーション、クリック、フォームの入力）

• 環境変数を通じて設定可能な Puppeteer オプション

構成

カスタムPuppeteerオプションの使用

PUPPETEER_ARGS環境変数にJSON文字列を指定することで、Puppeteerの起動オプションを設定できます。これにより、サーバーコードを変更することなくブラウザの動作をカスタマイズできます。

例: Chromeの代わりにFirefoxを使用する

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"],
      "env": {
        "PUPPETEER_ARGS": "{\"browser\": \"firefox\"}"
      }
    }
  }
}

例: ブラウザウィンドウサイズの設定

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"],
      "env": {
        "PUPPETEER_ARGS": "{\"defaultViewport\": {\"width\": 1280, \"height\": 800}}"
      }
    }
  }
}

標準構成

NPX

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"]
    }
  }
}

ブランチ、タグ、コミットを指定することもできます。

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer#main"]
    }
  }
}

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。