Playwright MCP Server

🚀 Playwright MCP サーバー

English | 日本語

このプロジェクトは、Model Context Protocol (MCP) を使用して Playwright を介したウェブページコンテンツの検索機能を提供するサーバーです。

✨ 主な機能

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

📦 インストール

Smithery を使用した自動インストール

Smithery を通じて、Claude Desktop 用に Playwright MCP Server を自動インストールします。

npx -y @smithery/cli install @showfive/playwright-mcp-server --client claude

手動インストール

npm install

💻 使用例

基本的な使用法

サーバーの起動

npm run build
npm start

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 }
   • 戻り値: 送信されたメッセージ

📚 ドキュメント

開発

テストの実行

# すべてのテストを実行
npm test

# watch モードでテストを実行
npm run test:watch

# カバレッジレポートを生成
npm run test:coverage

テスト構造

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

実装の特徴

• コンテンツ取得：ページコンテンツを効率的に検索し、可視および不可視コンテンツをサポートします。
• インタラクティブ操作：マウスの移動、クリック、スクロールなどのユーザー操作をシミュレートします。
• エラー処理：完全な例外処理メカニズムがあり、サーバーの安定した動作を保証します。
• 設定の柔軟性：ヘッドレスモード、カスタムユーザーエージェントなどの設定オプションをサポートします。

🔧 注意事項

⚠️ 重要提示

1. サーバーが正常に動作するように、必要な環境変数を設定してください。
2. ターゲットウェブサイトのサービス条項と使用規則に従ってください。
3. リクエストを送信する際には適切な時間間隔を設け、反スクレイピングメカニズムをトリガーしないようにしてください。
4. マウス操作をシミュレートする際には、頻度をコントロールし、悪意のある攻撃と誤判定されないようにしてください。

📄 まとめ

Playwright MCP サーバーは、Playwright の強力な自動化機能を活用して、柔軟で拡張可能なプラットフォームを構築し、他のサービスやモデルがその機能を呼び出せるようにします。ウェブ自動化テスト、データ収集、またはその他の類似のタスクを必要とする開発者にとって、これは非常に有用なツールです。