Configurable Puppeteer MCP Server

by afshawnlotfi
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports interaction with web elements using CSS selectors for operations like clicking, hovering, filling form fields, and capturing specific elements in screenshots.

  • Offers the ability to use Firefox instead of Chrome as the browser engine through custom Puppeteer configuration options.

  • Enables execution of JavaScript code in the browser context through the puppeteer_evaluate tool, allowing for dynamic interaction with web page content.

設定可能な Puppeteer MCP サーバー

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

コンポーネント

ツール

  • 操り人形師ナビゲート
    • ブラウザで任意の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 オプション

構成

カスタムPuppeteerオプションの使用

PUPPETEER_ARGS環境変数にJSON文字列を指定することで、Puppeteerの起動オプションを設定できます。これにより、サーバーコードを変更することなくブラウザの動作をカスタマイズできます。

例: Chromeの代わりにFirefoxを使用する

{ "mcpServers": { "puppeteer": { "command": "npx", "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"], "env": { "PUPPETEER_ARGS": "{\"browser\": \"firefox\"}" } } } }

例: ブラウザウィンドウサイズの設定

{ "mcpServers": { "puppeteer": { "command": "npx", "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"], "env": { "PUPPETEER_ARGS": "{\"defaultViewport\": {\"width\": 1280, \"height\": 800}}" } } } }

標準構成

NPX

{ "mcpServers": { "puppeteer": { "command": "npx", "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"] } } }

ブランチ、タグ、コミットを指定することもできます。

{ "mcpServers": { "puppeteer": { "command": "npx", "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer#main"] } } }

ライセンス

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

-
security - not tested
F
license - not found
-
quality - not tested

環境変数を通じて構成可能なオプションを備えた Puppeteer を使用してブラウザ自動化機能を提供するモデル コンテキスト プロトコル サーバー。これにより、LLM が Web ページと対話し、スクリーンショットを撮り、ブラウザ環境で JavaScript を実行できるようになります。

  1. Components
    1. Tools
    2. Resources
  2. Key Features
    1. Configuration
      1. Using with Custom Puppeteer Options
      2. Standard Configuration
    2. License
      ID: be53p5xcw8