MCP Configurable Puppeteer

🚀 可配置 Puppeteer MCP サーバー

Puppeteer を使用してブラウザ自動化機能を実現した Model Context Protocol サーバーで、設定オプションを提供します。このサーバーにより、大規模言語モデルはウェブページとの対話、スクリーンショットの取得、JavaScript の実行が可能で、実際のブラウザ環境で動作し、環境変数を通じて Puppeteer の起動オプションをカスタマイズできます。

✨ 主な機能

• ブラウザ自動化
• コンソールログの監視
• スクリーンショット取得機能
• JavaScript の実行
• 基本的なウェブページの対話（ナビゲーション、クリック、フォーム入力）
• 環境変数による 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 形式のページのスクリーンショットです。
   • 取得時に指定したスクリーンショットの名前でアクセスできます。

高度な使用法

カスタム 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}}"
      }
    }
  }
}

標準設定

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

📚 ドキュメント

このセクションでは、具体的な詳細説明が記載されていません。

🔧 技術詳細

このセクションでは、具体的な技術実装の詳細が記載されていません。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。