Merajmehrabi Puppeteer MCP Server

🚀 uppeteer MCP サーバー

このMCPサーバーは、Puppeteerを通じてブラウザの自動化機能を提供し、新しいブラウザインスタンスや既存のChromeウィンドウとの相互作用をサポートします。

✨ 主な機能

• ウェブページの閲覧
• スクリーンショットの撮影
• 要素のクリック
• フォームの入力
• オプションの選択
• 要素上でのマウスホバー
• JavaScriptの実行
• スマートChromeタブ管理：
  • アクティブなChromeタブへの接続
  • 既存のChromeインスタンスの保持
  • スマート接続処理

📚 ドキュメント

プロジェクト構造

/
├── src/
│   ├── config/        # 設定モジュール
│   ├── tools/         # ツールの定義と処理プログラム
│   ├── browser/       # ブラウザ接続管理
│   ├── types/         # TypeScriptの型定義
│   ├── resources/     # リソース処理プログラム
│   └── server.ts      # サーバーの初期化
├── index.ts           # エントリーポイント
└── README.md         # ドキュメント

使用方法

標準モード

サーバーはデフォルトで新しいブラウザインスタンスを起動します。

アクティブタブモード

既存のChromeウィンドウに接続するには：

1. すべての既存のChromeインスタンスを完全に閉じます。
2. Chromeを起動し、リモートデバッグを有効にします：
   • Windows または Linux：chrome.exe --remote-debugging-port=9222
   • Mac：open -a /Applications/Google\ Chrome.app --args --remote-debugging-port=9222
3. devtoolsFrontendUrl を含む新しいタブを開きます。

ツールリスト

• puppeteer_connect_active_tab：アクティブなChromeタブに接続する
• puppeteer_create_new_tab：新しいChromeタブを作成する
• puppeteer_navigate_to_url：指定されたURLに移動する
• puppeteer_close_current_tab：現在のタブを閉じる
• puppeteer_screenshot_page：ページのスクリーンショットを撮影する

セキュリティに関する注意事項

⚠️ 重要提示

• サーバーは信頼できる環境でのみ実行してください。
• 本番環境では機密情報を平文で送信しないでください。
• セキュリティホールを防ぐために、定期的に依存関係を更新してください。

ログ記録

概要

サーバーは詳細なログ記録機能を提供し、以下を含みます：

• 操作のタイムスタンプ
• リクエストのコンテキスト情報
• 操作の実行結果
• エラーの詳細情報

すべてのログはデフォルトで ./logs/ ディレクトリに日付ごとに保存されます。

エラー処理

サポートされるエラータイプ

• 接続失敗
• 要素が見つからない
• 無効なセレクター
• JavaScriptの実行エラー
• スクリーンショットの撮影失敗

各ツールの呼び出しは以下を返します：

• 成功/失敗のステータス
• 失敗時の詳細なエラー情報
• 成功した操作の結果データ

すべてのエラーはログファイルに記録され、以下を含みます：

• タイムスタンプ
• エラーメッセージ
• スタックトレース（ある場合）
• コンテキスト情報

貢献ガイド

貢献を歓迎します！ プルリクエストの提出方法、問題の報告方法、およびプロジェクトへの貢献方法については、CONTRIBUTING.md を参照してください。

📄 ライセンス

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