Puppeteer Extra Stealth

🚀 Puppeteer-Extra MCP サーバー

Puppeteer-ExtraとStealthプラグインを使用して、ブラウザ自動化機能を強化したモデルコンテキストプロトコル（Model Context Protocol）サーバーです。このサーバーにより、LLMは人間に近い行動でウェブページと対話でき、自動化プログラムとして識別されるのを防ぎます。

✨ 主な機能

• Puppeteer-Extraを使用した高度なブラウザ自動化
• 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://<名前>)

• ページまたは要素のPNG形式のスクリーンショット画像
• スクリーンショット時に指定した名前でアクセスできます。

🛠️ 開発

📦 インストール

# リポジトリをクローンする
git clone <リポジトリアドレス>
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", "MCP_puppeteer_extra"]
    }
  }
}

📄 ライセンス

このMCPサーバーはMIT Licenseのオープンソースライセンスで提供されています。