Patchright Lite MCP サーバー

Patchright Node.js SDKをラップし、AIモデルにステルスブラウザ自動化機能を提供する、合理化されたモデルコンテキストプロトコル（MCP）サーバーです。この軽量サーバーは、よりシンプルなAIモデルを容易に利用できるよう、必須機能に特化しています。

Patchright とは何ですか?

Patchrightは、Playwrightテストおよび自動化フレームワークの検出されないバージョンです。Playwrightの代替として設計されていますが、アンチボットシステムによる検出を回避するための高度なステルス機能を備えています。Patchrightは、以下を含む様々な検出手法にパッチを適用します。

Runtime.enable リーク
Console.enable リーク
コマンドフラグの漏洩
一般的な検出ポイント
クローズドシャドウルートインタラクション

この MCP サーバーは、Patchright の Node.js バージョンをラップし、シンプルで標準化されたプロトコルを通じて AI モデルでその機能を利用できるようにします。

特徴

シンプルなインターフェース: 4つの必須ツールのみでコア機能に焦点を合わせています
ステルス自動化: Patchrightのステルスモードを使用して検出を回避します
MCP 標準: AI 統合を容易にするモデルコンテキストプロトコルを実装
Stdioトランスポート: シームレスな統合のために標準入出力を使用します

前提条件

Node.js 18歳以上
npmまたはyarn

インストール

このリポジトリをクローンします:
git clone https://github.com/yourusername/patchright-lite-mcp-server.git cd patchright-lite-mcp-server
依存関係をインストールします:
npm install
TypeScript コードをビルドします。
npm run build

使用法

次のコマンドでサーバーを実行します。

npm start

これにより、stdio トランスポートを使用してサーバーが起動し、MCP をサポートする AI ツールと統合できるようになります。

AIモデルとの統合

クロードデスクトップ

claude-desktop-config.jsonファイルに以下を追加します。

{
  "mcpServers": {
    "patchright": {
      "command": "node",
      "args": ["path/to/patchright-lite-mcp-server/dist/index.js"]
    }
  }
}

GitHub Copilot を使用した VS Code

VS Code CLI を使用して MCP サーバーを追加します。

code --add-mcp '{"name":"patchright","command":"node","args":["path/to/patchright-lite-mcp-server/dist/index.js"]}'

利用可能なツール

サーバーは 4 つの必須ツールのみを提供します。

1. 閲覧

ブラウザを起動し、URL に移動してコンテンツを抽出します。

Tool: browse
Parameters: {
  "url": "https://example.com",
  "headless": true,
  "waitFor": 1000
}

戻り値:

ページタイトル
表示されるテキストのプレビュー
ブラウザID（後続の操作用）
ページID（後続の操作用）
スクリーンショットのパス

2. 交流する

ページ上で簡単な操作を実行します。

Tool: interact
Parameters: {
  "browserId": "browser-id-from-browse",
  "pageId": "page-id-from-browse",
  "action": "click", // can be "click", "fill", or "select"
  "selector": "#submit-button",
  "value": "Hello World" // only needed for fill and select
}

戻り値:

アクション結果
現在のURL
スクリーンショットのパス

3. 抽出

現在のページから特定のコンテンツを抽出します。

Tool: extract
Parameters: {
  "browserId": "browser-id-from-browse",
  "pageId": "page-id-from-browse",
  "type": "text" // can be "text", "html", or "screenshot"
}

戻り値:

要求されたタイプに基づいて抽出されたコンテンツ

4. 閉じる

ブラウザを閉じてリソースを解放します。

Tool: close
Parameters: {
  "browserId": "browser-id-from-browse"
}

使用フローの例

ブラウザを起動してサイトに移動します。
Tool: browse Parameters: { "url": "https://example.com/login", "headless": false }
ログインフォームに記入してください:
Tool: interact Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "action": "fill", "selector": "#username", "value": "user@example.com" }
パスワードを入力してください:
Tool: interact Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "action": "fill", "selector": "#password", "value": "password123" }
ログインボタンをクリックします:
Tool: interact Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "action": "click", "selector": "#login-button" }
ログインを確認するためのテキストを抽出します:
Tool: extract Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "type": "text" }
ブラウザを閉じます:
Tool: close Parameters: { "browserId": "browser-id-from-step-1" }

セキュリティに関する考慮事項

このサーバーは強力な自動化機能を提供します。責任を持って倫理的にご利用ください。
ウェブサイトの利用規約に違反するアクションの自動化は避けてください。
レート制限に留意し、リクエストでウェブサイトに過負荷をかけないようにしてください。

ライセンス

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

謝辞

Kaliiiiiiiiii-Vinyzu による Patchright-nodejs
modelcontextprotocol によるモデルコンテキストプロトコル

Dockerの使用

このサーバーは Docker を使用して実行できます。

docker run -it --rm dylangroos/patchright-mcp

ローカルでDockerイメージを構築する

Docker イメージをビルドします。

docker build -t patchright-mcp .

コンテナを実行します。

docker run -it --rm patchright-mcp

Dockerハブ

変更がメインブランチにマージされると、イメージは自動的にDocker Hubに公開されます。最新のイメージはdylangroos/patchright-mcpで入手できます。

Patchright Lite MCP Server

Integrations