MCP Puppeteer Extra

🚀 Puppeteer-Extra MCP サーバー

Puppeteer-ExtraとStealthプラグインを使用して、ブラウザ自動化機能を強化したモデルコンテキストプロトコル（Model Context Protocol）サーバーです。このサーバーにより、大規模言語モデルは人間の行動に近い方法でWebページと対話でき、自動化操作として検出されるのを回避できます。

✨ 主な機能

• 強化されたブラウザ自動化機能
• Stealthモードによる反ボット検出の回避
• ページや要素のスクリーンショット機能
• ブラウザコンソールのログ記録とJavaScriptの実行
• 完全なインタラクションメソッド（クリック、入力、選択、ホバー）

📦 コンポーネント

ツール

• puppeteer_navigate

  • 任意のURLにナビゲートします。
  • 入力：url（文字列）

• puppeteer_screenshot

  • ページまたは要素のスクリーンショットを撮ります。
  • 入力：
    • name（文字列、必須）：スクリーンショットの名前
    • selector（文字列、オプション）：要素をスクリーンショットするためのCSSセレクター
    • width（数値、オプション、デフォルト：800）：スクリーンショットの幅
    • height（数値、オプション、デフォルト：600）：スクリーンショットの高さ

• puppeteer_click

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

• puppeteer_hover

  • ページ上の要素にホバーします。
  • 入力：selector（文字列）：ホバーする要素のセレクター

• puppeteer_fill

  • 入力フィールドに内容を入力します。
  • 入力：
    • selector（文字列）：入力フィールドのセレクター
    • value（文字列）：入力する内容

• puppeteer_select

  • SELECTタグ内の要素を選択します。
  • 入力：
    • selector（文字列）：選択する要素のセレクター
    • value（文字列）：選択する値

• puppeteer_evaluate

  • ブラウザコンソールでJavaScriptコードを実行します。
  • 入力：script（文字列）：実行するJavaScriptスクリプト

リソース

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

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

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

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

   • ページ要素のPNG画像をキャプチャします。
   • 指定したスクリーンショット名でアクセスできます。

📦 インストール

# リポジトリをクローンする
git clone <repository-url>
cd puppeteer_extra

# 依存関係をインストールする
npm install

# 環境ファイルをコピーする
cp .env.example .env.development

💻 使用例

ローカルでの実行

# 開発モード（非ヘッドレスブラウザ）
npm run dev

# 本番モード（ヘッドレスブラウザ）
npm run prod

ビルド

npm run build

🐳 Docker

Dockerイメージのビルド

docker build -t mcp/puppeteer-extra .

Dockerでの実行

docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer-extra

📚 ドキュメント

Claude Desktop用の設定

Docker

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

NPX

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "MCPuppeteerExtra"]
    }
  }
}

📄 ライセンス

[ここに具体的なライセンス情報を追加する必要があります]