Playwright MCP サーバー

英語 |日本語

このプロジェクトは、モデル コンテキスト プロトコル (MCP) を使用して Playwright Web ページ コンテンツ取得機能を提供するサーバーです。

特徴

• ページナビゲーション
• 全ページコンテンツ取得
• 可視コンテンツの検索
• インタラクティブ要素の検出
• マウス操作シミュレーション
• テスト用のエコー機能

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Playwright MCP Server を自動的にインストールするには:

手動インストール

使用法

サーバーの起動

MCPツール

利用可能なツールは次のとおりです。

1. navigate
   • 指定されたURLに移動する
   • 引数: { url: string }
   • 戻り値: ナビゲーション結果
2. get_all_content
   • ページ全体からコンテンツを取得する
   • 引数: なし
   • 戻り値: ページのすべてのテキストコンテンツ
3. get_visible_content
   • 現在表示されているコンテンツを取得する
   • 引数: { minVisiblePercentage?: number }
   • 戻り値: 表示されるテキストコンテンツ
4. get_interactive_elements
   • ページ上のインタラクティブな要素（ボタン、リンクなど）の位置情報を取得します。
   • 引数: なし
   • 戻り値: インタラクティブ要素の座標と境界情報
5. move_mouse
   • マウスカーソルを指定した座標に移動する
   • 引数: { x: number, y: number }
   • 戻り値: 演算結果
6. mouse_click
   • 指定された座標でマウスクリックを実行する
   • 引数: { x: number, y: number, button?: "left" | "right" | "middle", clickCount?: number }
   • 戻り値: クリック操作の結果
7. mouse_wheel
   • マウスホイールスクロールを実行する
   • 引数: { deltaY: number, deltaX?: number }
   • 戻り値: スクロール操作の結果
8. drag_and_drop
   • ドラッグアンドドロップ操作を実行する
   • 引数: { sourceX: number, sourceY: number, targetX: number, targetY: number }
   • 戻り値: ドラッグアンドドロップ操作の結果
9. echo
   • テスト用のエコーツール
   • 引数: { message: string }
   • 戻り値: 送信されたメッセージ

発達

テストの実行

テスト構造

• tools/*.test.ts : 各ツールの機能テスト
• mcp-server.test.ts : MCP サーバー機能テスト

実装機能

1. コンテンツ検索
   • 全ページコンテンツ取得
   • 表示コンテンツのみの取得
   • 適切なHTML解析
2. 交流
   • インタラクティブ要素の検出と位置情報の取得
   • マウス操作シミュレーション（移動、クリック、スクロール）
   • ドラッグアンドドロップのサポート
3. エラー処理
   • 適切なナビゲーションエラー処理
   • タイムアウト処理
   • 無効なURLの検出
4. 構成の柔軟性
   • ヘッドレス/ヘッドモードの選択
   • カスタムユーザーエージェント
   • ビューポートサイズ設定

重要な注意事項

• MCPサーバーを使用する前に、必要な環境変数が設定されていることを確認してください。
• ウェブページのコンテンツを取得する際は、対象ウェブサイトの利用規約に従ってください。
• 複数のリクエストを送信する場合は適切な間隔を維持する
• マウス操作を行う際は、実際のユーザーインタラクションをシミュレートするため、適切な間隔を維持します。

ライセンス

ISC