Puppeteer MCP Server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Enables interaction with web page elements through CSS selectors for actions like clicking, hovering, and capturing screenshots of specific elements

  • Allows executing JavaScript code in the browser console using the puppeteer_evaluate tool

  • Provides browser automation capabilities using Puppeteer, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment

操り人形師

Puppeteerを用いたブラウザ自動化機能を提供するモデルコンテキストプロトコル(LLM)サーバー。このサーバーにより、LLMはWebページとのインタラクション、スクリーンショットの取得、そして実際のブラウザ環境でのJavaScript実行が可能になります。

コンポーネント

ツール

  • 操り人形師ナビゲート
    • ブラウザで任意のURLに移動する
    • 入力: url (文字列)
  • 操り人形師のスクリーンショット
    • ページ全体または特定の要素のスクリーンショットをキャプチャします
    • 入力:
      • name (文字列、必須): スクリーンショットの名前
      • selector (文字列、オプション):スクリーンショットを撮る要素のCSSセレクター
      • width (数値、オプション、デフォルト:800):スクリーンショットの幅
      • height (数値、オプション、デフォルト:600):スクリーンショットの高さ
  • 操り人形師クリック
    • ページ上の要素をクリック
    • 入力: selector (文字列): クリックする要素の CSS セレクター
  • 操り人形師_hover
    • ページ上の要素をホバーする
    • 入力: selector (文字列): ホバーする要素の CSS セレクター
  • 操り人形師の塗りつぶし
    • 入力フィールドに記入してください
    • 入力:
      • selector (文字列):入力フィールドのCSSセレクター
      • value (文字列): 入力する値
  • 操り人形師の選択
    • SELECTタグで要素を選択する
    • 入力:
      • selector (文字列): 選択する要素の CSS セレクター
      • value (文字列): 選択する値
  • 操り人形師の評価
    • ブラウザコンソールでJavaScriptを実行する
    • 入力: script (文字列): 実行するJavaScriptコード

リソース

サーバーは、次の 2 種類のリソースへのアクセスを提供します。

  1. コンソールログ( console://logs )
    • ブラウザコンソールのテキスト形式の出力
    • ブラウザからのすべてのコンソールメッセージが含まれます
  2. スクリーンショット( screenshot://<name> )
    • キャプチャしたスクリーンショットのPNG画像
    • キャプチャ時に指定したスクリーンショット名からアクセスできます

主な特徴

  • ブラウザ自動化
  • コンソールログ監視
  • スクリーンショット機能
  • JavaScript実行
  • 基本的なウェブインタラクション(ナビゲーション、クリック、フォームの入力)

Puppeteer Serverを使用するための設定

Puppeter サーバーを使用するための Claude Desktop の構成は次のとおりです。

ドッカー

注: docker 実装ではヘッドレス Chromium が使用されますが、NPX バージョンではブラウザー ウィンドウが開きます。

{ "mcpServers": { "puppeteer": { "command": "docker", "args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "mcp/puppeteer"] } } }

NPX

{ "mcpServers": { "puppeteer": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-puppeteer"] } } }

建てる

Dockerビルド:

docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

LLM が Web 閲覧タスクを実行し、スクリーンショットを撮り、ブラウザ自動化用の Puppeteer を使用して JavaScript を実行できるようにします。

  1. Components
    1. Tools
    2. Resources
  2. Key Features
    1. Configuration to use Puppeteer Server
      1. Docker
      2. NPX
    2. Build
      1. License
        ID: anvpl8ffa6