MCP-Puppeteer-Linux

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

ディスプレイサーバーのサポート

このフォークは、Linux ディスプレイ サーバーの自動検出と構成を追加します。

• X11/Waylandの自動検出

• 動的環境変数の設定

• さまざまなデスクトップ環境 (GNOME、KDE など) のサポート

• フォールバックメカニズムと堅牢なエラー処理

• XWaylandの互換性

Related MCP server: mcp-server-browserbase

コンポーネント

ツール

• 操り人形師ナビゲート

  • ブラウザで任意のURLに移動する

  • 入力: url (文字列)

• 操り人形師のスクリーンショット

  • ページ全体または特定の要素のスクリーンショットをキャプチャします

  • 入力:

    • name (文字列、必須): スクリーンショットの名前

    • selector （文字列、オプション）：スクリーンショットを撮る要素のCSSセレクター

    • width （数値、オプション、デフォルト：800）：スクリーンショットの幅

    • height （数値、オプション、デフォルト：600）：スクリーンショットの高さ

• 操り人形師クリック

  • ページ上の要素をクリック

  • 入力: selector (文字列): クリックする要素の CSS セレクター

• 操り人形師_hover

  • ページ上の要素をホバーする

  • 入力: selector (文字列): ホバーする要素の CSS セレクター

• 操り人形師の塗りつぶし

  • 入力フィールドに記入してください

  • 入力:

    • selector （文字列）：入力フィールドのCSSセレクター

    • value (文字列): 入力する値

• 操り人形師の選択

  • SELECTタグで要素を選択する

  • 入力:

    • selector (文字列): 選択する要素の CSS セレクター

    • value (文字列): 選択する値

• 操り人形師の評価

  • ブラウザコンソールでJavaScriptを実行する

  • 入力: script (文字列): 実行するJavaScriptコード

リソース

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

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

   • ブラウザコンソールのテキスト形式の出力

   • ブラウザからのすべてのコンソールメッセージが含まれます

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

   • キャプチャしたスクリーンショットのPNG画像

   • キャプチャ時に指定したスクリーンショット名からアクセスできます

主な特徴

• Linux ディスプレイ サーバーのサポートによるブラウザー自動化

• X11/Waylandの自動検出と設定

• コンソールログ監視

• スクリーンショット機能

• JavaScript実行

• 基本的なウェブインタラクション（ナビゲーション、クリック、フォームの入力）

構成

クロードデスクトップ構成

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop に Puppeteer Linux を自動的にインストールするには:

手動インストール

1. リポジトリをクローンします。

2. 依存関係をインストールします:

3. サーバーを起動します。

サーバーの詳細を表示

サーバーは適切な表示環境を自動的に検出し、構成します。

Wayland サポート

• WAYLAND_DISPLAY経由で Wayland セッションを検出します

• 必要な環境変数を設定します。

  • WAYLAND_DISPLAY

  • QT_QPA_PLATFORM

  • GDK_BACKEND

  • MOZ_ENABLE_WAYLAND

  • XDG_SESSION_TYPE

X11 サポート

• 従来の X11 セッションのフォールバック

• X11 固有の変数を処理します。

  • DISPLAY

  • XAUTHORITY

• さまざまなデスクトップ環境とウィンドウマネージャーをサポート

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。