MCP Puppeteer Linux

🚀 MCP-Puppeteer-Linux

Puppeteerを使用したブラウザ自動化機能を提供するモデルコンテキストプロトコルサーバで、Linuxの表示サーバ（X11とWayland）を完全にサポートしています。このサーバにより、LLMは実際のブラウザ環境でウェブページとの対話、スクリーンショットの取得、JavaScriptの実行が可能になります。

🚀 クイックスタート

このサーバは、Puppeteerを使用してブラウザ自動化機能を提供し、Linuxの表示サーバ（X11とWayland）を完全にサポートしています。LLMはこのサーバを通じて、実際のブラウザ環境でウェブページとの対話、スクリーンショットの取得、JavaScriptの実行が可能です。

✨ 主な機能

• ブラウザ自動化（Linux表示サーバサポート付き）
• X11/Waylandの自動検出と設定
• コンソールログの監視
• スクリーンショット取得機能
• JavaScript実行
• 基本的なウェブページ操作（ナビゲート、クリック、フォーム入力）

📦 インストール

1. まず依存関係をインストールします：

npm install puppeteer

2. 設定ファイルを作成し、サービスを起動します。

💻 使用例

基本的な使用法

以下はClaude Desktopの設定例です：

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["ts-node", "/path/to/your/script.ts"]
    }
  }
}

📚 ドキュメント

表示サーバサポート

このブランチでは、Linux表示サーバの自動検出と設定が追加されています：

• X11/Waylandの自動検出
• 動的な環境変数設定
• 様々なデスクトップ環境（GNOME、KDEなど）のサポート
• フォールバック機構と強力なエラー処理
• XWayland互換性

コンポーネント

ツール

• 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://<name>）
   • 名前で指定されたスクリーンショットのPNG画像を提供します。
   • スクリーンショットの名前で取得したスクリーンにアクセスできます。

表示サーバサポート

• Wayland：Wayland表示サーバを自動検出して使用します。
• X11：X11表示サーバを自動検出して使用します。

これらの設定により、異なる表示環境でPuppeteerを柔軟に実行できます。