Playwright MCP Server Bp6

🚀 Playwright MCP サーバー

English | 日本語

このプロジェクトは、モデルコンテキストプロトコル（MCP）を使用して、Playwright を用いたウェブページのコンテンツ検索機能を提供するサーバーです。

✨ 主な機能

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

📦 インストール

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

Smithery を通じて、Claude デスクトップ版の Playwright MCP サーバーを自動的にインストールします。

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

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

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

テスト構造

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

実装の特徴

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

⚠️ 重要提示

• MCP サーバーを使用する前に、環境変数を設定する必要があります。
• 関連ウェブサイトの利用規約を遵守してください。
• このツールを安全かつ適法に使用するようにしてください。

📄 ライセンス

このプロジェクトは ISC ライセンスの下で提供されています。