Puppeteer Linux

🚀 MCP-Puppeteer-Linux

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

🚀 クイックスタート

このモデルコンテキストプロトコルサーバーは、Puppeteerを用いてブラウザ自動化機能を提供し、Linux表示サーバーをサポートします。LLMがWebページとの対話やスクリーンショットの取得などを行えるようになります。

✨ 主な機能

• ブラウザ自動化機能
• 表示サーバーサポート（X11とWayland）
• 動的環境変数構成
• フォールバックメカニズムと堅牢なエラー処理
• XWayland互換性

📦 インストール

Smitheryによる自動インストール

# 以下のコマンドを使用して自動インストールします：
smithery install @PhialsBasement/mcp-puppeteer-linux

手動インストール

1. このリポジトリをクローンします：

   git clone https://github.com/PhialsBasement/mcp-puppeteer_linux.git
   cd mcp-puppeteer_linux
   

2. 依存関係をインストールして実行します：

   npm install
   node index.js
   

💻 使用例

基本的な使用法

以下はClaudeデスクトップ用の設定例です：

{
  "mcp": {
    "servers": [
      {
        "name": "puppeteer_navigate",
        "command": "cd /path/to/app && npm start"
      },
      {
        "name": "puppeteer_screenshot",
        "command": "cd /path/to/app && npm run screenshot"
      }
    ]
  }
}

📚 ドキュメント

表示サーバーサポート

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

• X11/Waylandの自動検出
• 動的環境変数構成
• 様々なデスクトップ環境（GNOME、KDEなど）のサポート
• フォールバックメカニズムと堅牢なエラー処理
• XWayland互換性

コンポーネント

ツール

• puppeteer_navigate
  • ブラウザで任意のURLに移動します。
  • 入力：url (文字列)
• puppeteer_screenshot
  • Webページまたは特定の要素のスクリーンショットを取得します。
  • 入力：
    • 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セレクター
• puppeteer_execute_javascript
  • ターゲットコンテキストでJavaScript式を実行します。
  • 入力：
    • expression (文字列)：実行するJavaScript式

リソース

• Console Log：特定のURL形式を使用して、コンソールログ出力を提供します。
• Screenshot：特定のURL形式を使用して、スクリーンショットリソースを提供します。

表示サーバー詳細情報

Waylandサポート

• Wayland環境変数の自動検出と設定。
• XWayland互換性のサポート。

X11サポート

• 従来のLinux表示サーバーをサポートするためのX11環境変数の設定。

📄 ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。詳細については、LICENSEファイルを参照してください。