Playwright Plus Python MCP

🚀 Playwright Server MCP

PlaywrightをベースにしたMCPサーバーで、ブラウザーの自動化機能を提供します

✨ 主な機能

🔖 リソース

サーバーはシンプルなノート保存システムを実装しています。

• 単一のノートにアクセスするためのカスタムnote://URIスキームが用意されています。
• 各ノートリソースには、名前、説明、およびtext/plain MIMEタイプがあります。

💡 プロンプト

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

• summarize-notes: 保存されているすべてのノートの要約を作成します。
  • 詳細度を制御するためのオプションの"style"パラメーター（brief/detailed）があります。
  • 現在のすべてのノートとスタイルの好みを組み合わせたプロンプトを生成します。

🛠️ ツール

サーバーは以下のPlaywright関連ツールを実装しています。

セッションとナビゲーション

• playwright_new_session: 新しいブラウザーセッションを作成し、ブラウザーウィンドウを開きます。
  • オプションのurlパラメーター（文字列）で、初期アクセスするURLを指定できます。指定しない場合はブラウザーのみを開きます。
• playwright_navigate: 指定されたURLにナビゲートします。
  • urlパラメーター（文字列）が必要です。httpまたはhttpsプレフィックスが含まれていない場合は、自動的にhttps://が追加されます。
  • アクティブなブラウザーセッションがない場合は、自動的に新しいセッションが作成されます。

ページの操作とコンテンツの取得

• playwright_screenshot: 現在のページまたは特定の要素をスクリーンショットします。
  • nameパラメーター（文字列）が必要で、スクリーンショットのファイル名を指定します（拡張子は不要）。
  • オプションのselectorパラメーター（文字列）で、スクリーンショットを撮るページ要素を指定するCSSセレクターを指定できます。指定しない場合は、ページ全体を撮影します。
• playwright_evaluate: ブラウザーコンソールでJavaScriptコードを実行します。
  • scriptパラメーター（文字列）が必要で、ブラウザーで実行するJavaScriptコードを指定します。
• playwright_get_text_content: 現在のページのすべての可視要素のテキストコンテンツを取得します。
  • パラメーターは不要です。
  • 重複するコンテンツを自動的にフィルタリングし、意味のあるテキストのみを返します。
• playwright_get_html_content: ページ内の指定された要素のHTMLコンテンツを取得します。
  • selectorパラメーター（文字列）が必要で、HTMLコンテンツを取得するページ要素を指定するCSSセレクターを指定します。

高度な操作

• playwright_action: 豊富な要素選択と操作方法をサポートします。
  • 必須パラメーター:
    • by: 要素を選択する方法で、get_by_text、get_by_placeholder、get_by_label、get_by_roleなどがサポートされています。
    • by_value: 要素を選択するための値です。
    • action: 操作のタイプで、fill、click、dblclick、hover、checkなどがあります。
  • オプションパラメーター:
    • value: 操作の値です。
    • force: アクションを強制的に実行するかどうかを指定します。
    • delay: キー入力間の遅延（ミリ秒）です。
    • その他の専用パラメーターについては、コードドキュメントを参照してください。

📦 インストール

システム要件

• Python 3.10以上
• Playwright 1.44以上

クイックスタート

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/ディレクトリにソースコードとwheel配布物が作成されます。

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\xxxxx\Documents\project\python\mcp\playwright-server run playwright-server

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

💻 使用例

基本的な使用法

# セッションを作成し、指定されたURLにナビゲートします
await playwright_navigate(url="example.com")

# ページ全体をスクリーンショットします
await playwright_screenshot(name="fullpage")

# 特定の要素をスクリーンショットします
await playwright_screenshot(name="logo", selector=".logo")

高度な使用法

# テキストが一致するボタンをクリックします
await playwright_action(by="get_by_text", by_value="ログイン", action="click")

# フォームフィールドに入力します
await playwright_action(by="get_by_placeholder", by_value="ユーザー名", action="fill", value="test@example.com")

# 要素が表示されているかどうかを確認します
await playwright_action(by="get_by_test_id", by_value="submit-button", action="is_visible")