Playwright

🚀 MCP サーバー Playwright

モデルコンテキストプロトコル（MCP）サーバーで、Playwright を使用したブラウザ自動化機能を提供します。大規模言語モデルがウェブページと対話し、スクリーンショットを取得し、実際のブラウザ環境で JavaScript を実行できるようにします。

🚀 クイックスタート

MCP サーバー Playwright は、Playwright に基づくツールで、ブラウザ環境で自動化操作を実行するために使用されます。これは、スクリーンショットの取得、コンソールログのキャプチャ、ウェブページ要素との対話など、さまざまなブラウザ機能をサポートしています。

const { createServer } = require('@automatalabs/mcp-server-playwright');

async function main() {
  const server = await createServer();
  await server.start();
}

📦 インストール

以下のコマンドを使用して、MCP サーバー Playwright をインストールします。

npm install @automatalabs/mcp-server-playwright

✨ 主な機能

ブラウザ操作

• ナビゲーション：URL を使用してウェブページにアクセスします。

  await page.goto('https://example.com');
  

• スクリーンショットの取得：現在のビューの PNG 画像をキャプチャします。

  const screenshot = await page.screenshot();
  

• コンソールログ：ブラウザのコンソール出力を取得します。

  const logs = await page.logs();
  

要素の操作

• 要素のクリック：セレクタまたはテキストを使用して要素を見つけてクリックします。

  await page.click('#menu-item');
  await page.clickText('Hover me');
  

• フォームの入力：入力フィールドに内容を入力します。

  await page.fill('#input-field', 'Hello World');
  

• ドロップダウンオプションの選択：セレクタまたはテキストを使用して、ドロップダウンメニューからオプションを選択します。

  await page.select('#dropdown', 'option-value');
  await page.selectText('#dropdown', 'Choose me');
  

スクリプトの実行

• JavaScript の実行：ブラウザ環境で任意のスクリプトを実行します。

  const title = await page.evaluate('document.title');
  

📚 ドキュメント

リソースのアクセス

1. スクリーンショットリソース (screenshot://<n>)：

   • 指定された名前の PNG 画像ファイルにアクセスします。
   • スクリーンショット取得コマンドを使用して取得します。

2. コンソールログリソース (console://logs)：

   • ブラウザのコンソール出力テキストを取得します。
   • すべてのコンソールメッセージが含まれます。

💻 使用例

const { createServer } = require('@automatalabs/mcp-server-playwright');

async function main() {
  const server = await createServer();
  await server.start();

  // ウェブページに移動
  await page.goto('https://example.com');

  // スクリーンショットを取得
  const screenshot = await page.screenshot({ name: 'homepage' });

  // フォームに入力
  await page.fill('#input-field', 'Hello World');
  
  // フォームを送信
  await page.click('#submit-button');

  console.log('操作が完了しました');
}

main().catch(console.error);

📄 ライセンス

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