MCP Puppeteer Server

🚀 木偶师サーバー

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

✨ 主な機能

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

📦 インストール

Docker

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

💻 使用例

Claude DesktopでのPuppeteerサーバーの設定例

Docker

⚠️ 重要提示

Docker版はヘッドレスChromiumを使用し、NPX版はブラウザウィンドウを開きます。

{
  "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（文字列）：クリックする要素のセレクター

• puppeteer_hover

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

• puppeteer_fill

  • 機能：フォームフィールドに入力します。
  • 入力パラメータ：
    • selector（文字列）：フォームフィールドのセレクター
    • value（文字列）：入力する内容

• puppeteer_select

  • 機能：ドロップダウンリストから要素を選択します。
  • 入力パラメータ：
    • selector（文字列）：ドロップダウンリストのセレクター
    • value（文字列）：選択する値

• puppeteer_evaluate

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

リソース

このサーバーは2種類のリソースを提供します：

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

   • ブラウザコンソールのテキスト出力情報
   • ブラウザのすべてのコンソールメッセージを含みます

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

   • PNG形式のページスクリーンショット
   • 取得時に指定した名前でスクリーンショットにアクセスできます

📄 ライセンス

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