playwright-server MCP server

playwright-server MCP サーバー

\Playwright ツールを備えた MCP サーバー\

コンポーネント

リソース

このサーバーは、シンプルなメモ保存システムを実装しています。

• 個々のメモにアクセスするためのカスタム note:// URI スキーム
• 各メモリソースには、名前、説明、text/plain MIME タイプがあります

プロンプト

このサーバーは、単一のプロンプトを提供します。

• summarize-notes：保存されているすべてのメモの要約を作成します
  • 詳細度（簡潔／詳細）を調整するための任意の「style」引数
  • 現在のすべてのメモとスタイルの設定を組み合わせたプロンプトを生成します

ツール

このサーバーは、以下のツールを実装しています。

• playwright_navigate：指定した URL に移動します。アクティブなセッションがない場合、この操作で新しいセッションが自動的に作成されます。
  • url 引数（文字列）が必要です。
• playwright_screenshot：現在のページまたは特定の要素のスクリーンショットを撮影します。
  • スクリーンショットのファイル名として、name 引数（文字列）が必要です。
  • スクリーンショットを撮影する要素を指定するための、任意の selector 引数（文字列）。指定しない場合は、ページ全体のスクリーンショットが撮影されます。
• playwright_click：CSS セレクターを使って、ページ上の要素をクリックします。
  • クリックする要素の CSS セレクターを指定するため、selector 引数（文字列）が必要です。
• playwright_fill：入力フィールドに値を入力します。
  • 入力フィールドの CSS セレクターを指定するため、selector 引数（文字列）が必要です。
  • 入力する値を指定するため、value 引数（文字列）が必要です。
• playwright_evaluate：ブラウザーのコンソールで JavaScript コードを実行します。
  • 実行する JavaScript コードを指定するため、script 引数（文字列）が必要です。
• playwright_click_text：ページ上の要素を、そのテキスト内容を使ってクリックします。
  • クリックする要素のテキスト内容を指定するため、text 引数（文字列）が必要です。
• playwright_get_text_content：表示されているすべての要素のテキスト内容を取得します。
• playwright_get_html_content：ページの HTML 内容を取得します。
  • 要素の CSS セレクターを指定するため、selector 引数（文字列）が必要です。

設定

[TODO: Add configuration details specific to your implementation]

クイックスタート

インストール

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

開発版／未公開サーバーの設定

``` "mcpServers": { "playwright-server": { "command": "uv", "args": [ "--directory", "C:\Users\xxxxx\Documents\project\python\mcp\playwright-server", "run", "playwright-server" ] } } ```

公開済みサーバーの設定

``` "mcpServers": { "playwright-server": { "command": "uvx", "args": [ "playwright-server" ] } } ```

開発

ビルドと公開

配布用にパッケージを準備するには、次の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージの配布物をビルドします。

uv build

これにより、dist/ ディレクトリにソース配布物とホイール配布物が作成されます。

3. PyPI に公開します。

uv publish

注：環境変数またはコマンドフラグを使って、PyPI の認証情報を設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名／パスワード：--username／UV_PUBLISH_USERNAME および --password／UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグが難しい場合があります。最適なデバッグ体験のため、MCP Inspector の使用を強くおすすめします。

次のコマンドを使って、npm 経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory C:\Users\YUNYING\Documents\project\python\mcp\playwright-server run playwright-server

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスして、デバッグを開始できます。