Puppeteer-Extra MCP Server

Puppeteer-Extra MCP サーバー

Model Context Protocol サーバーです。Stealth Plugin を使用した Puppeteer-Extra により、強化されたブラウザー自動化機能を提供します。このサーバーを使用すると、LLM は人間の動作をより適切に模倣し、自動化として検出されにくい方法でウェブページを操作できます。

機能

• Puppeteer-Extra による強化されたブラウザー自動化
• ボット検出を回避するステルスモード
• ページや要素のスクリーンショット機能
• コンソールログの記録と JavaScript の実行
• 一連の操作メソッド（クリック、入力、選択、ホバー）

コンポーネント

ツール

• puppeteer_navigate

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

• puppeteer_screenshot

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

• puppeteer_click

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

• puppeteer_hover

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

• puppeteer_fill

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

• puppeteer_select

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

• puppeteer_evaluate

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

リソース

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

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

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

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

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

開発

インストール

# Clone the repository
git clone <repository-url>
cd puppeteer_extra

# Install dependencies
npm install

# Copy environment file
cp .env.example .env.development

ローカルでの実行

# Development mode (non-headless browser)
npm run dev

# Production mode (headless browser)
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 ライセンスの下でライセンスされています。