Puppeteer

🚀 木偶师サーバー

Puppeteerを使用したモデルコンテキストプロトコル（MCP）サーバーで、ブラウザ自動化機能を提供します。このサーバーにより、LLMsはウェブページとのインタラクション、スクリーンショットの取得、JavaScriptの実行が可能で、実際のブラウザ環境で動作します。

🚀 クイックスタート

このサーバーを使用することで、LLMsがウェブページとのインタラクションを自動化できます。以下に、サーバーの主要な機能や使用方法を説明します。

✨ 主な機能

• ブラウザ自動化
• コンソールログ監視
• スクリーンショット機能
• JavaScript実行能力
• 基本的なウェブページインタラクション（ナビゲーション、クリック、フォーム入力）

📦 インストール

Docker

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

コンフィグ設定

Docker

{
  "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"]
    }
  }
}

📚 ドキュメント

コンポーネント

ツール

• 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形式のスクリーンショット画像
   • 取得時に指定したスクリーンショット名でアクセスできます。

📄 ライセンス

このMCPサーバーはMITライセンスの下で提供されています。これは、MITライセンスの条項と条件に従う限り、ソフトウェアを制限なく使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。