メインコンテンツへスキップ

Claude Code (WSL) に Puppeteer MCP サーバーをインストールする方法

    WSL2環境でClaude CodeにPuppeteer MCPサーバーを追加し、日本語対応させる手順です。

    前提条件

    • Claude Codeがインストール済み

    • WSL2 (Ubuntu)環境


    手順

    1. Puppeteer MCPサーバーの追加

    Claude Codeに Puppeteer MCPサーバーを追加します:

    claude mcp add puppeteer npx -- -y @modelcontextprotocol/server-puppeteer

    2. 設定の確認

    追加されたMCPサーバーを確認:

    claude mcp list

    以下のように表示されれば成功です:

    puppeteer: npx -y @modelcontextprotocol/server-puppeteer

    3. Claude Codeの再起動

    設定を反映させるため、Claude Codeを再起動してください。

    4. 必要なライブラリのインストール

    WSL2環境でPuppeteerを実行するために必要な依存関係をインストールします:

    sudo apt-get update && sudo apt-get install -y \
        ca-certificates \
        fonts-liberation \
        libasound2 \
        libatk-bridge2.0-0 \
        libatk1.0-0 \
        libc6 \
        libcairo2 \
        libcups2 \
        libdbus-1-3 \
        libexpat1 \
        libfontconfig1 \
        libgbm1 \
        libgcc1 \
        libglib2.0-0 \
        libgtk-3-0 \
        libnspr4 \
        libnss3 \
        libpango-1.0-0 \
        libpangocairo-1.0-0 \
        libstdc++6 \
        libx11-6 \
        libx11-xcb1 \
        libxcb1 \
        libxcomposite1 \
        libxcursor1 \
        libxdamage1 \
        libxext6 \
        libxfixes3 \
        libxi6 \
        libxrandr2 \
        libxrender1 \
        libxss1 \
        libxtst6 \
        lsb-release \
        wget \
        xdg-utils

    5. Ubuntu 24.04の場合の追加対応

    Ubuntu 24.04を使用している場合、以下のコマンドも実行してください:

    sudo apt-get install -y libasound2t64

    6. 日本語フォントのインストール

    日本語サイトで文字化けを防ぐため、日本語フォントをインストールします:

    sudo apt-get install -y fonts-noto-cjk fonts-ipafont fonts-ipaexfont

    7. インストールの確認

    日本語フォントが正しくインストールされたか確認:

    fc-list :lang=ja | head -5

    利用可能な機能

    インストール完了後、以下の機能が使用できます:

    • puppeteer_navigate - 指定したURLへナビゲート

    • puppeteer_screenshot - ページまたは特定要素のスクリーンショット撮影

    • puppeteer_click - 要素のクリック

    • puppeteer_fill - 入力フィールドへのテキスト入力

    • puppeteer_select - ドロップダウンメニューの選択

    • puppeteer_hover - 要素へのホバー

    • puppeteer_evaluate - ブラウザ内でのJavaScript実行

    使用例

    # URLへナビゲート
    mcp__puppeteer__puppeteer_navigate(url="https://www.google.com")
    
    # スクリーンショット撮影
    mcp__puppeteer__puppeteer_screenshot(name="screenshot", width=1280, height=800)
    
    # 要素のクリック
    mcp__puppeteer__puppeteer_click(selector="#submit-button")
    
    # フォームへの入力
    mcp__puppeteer__puppeteer_fill(selector="#search-box", value="検索キーワード")

    トラブルシューティング

    ライブラリエラーが発生する場合

    もし「error while loading shared libraries」などのエラーが発生した場合は、不足しているライブラリを個別にインストールしてください。

    日本語が文字化けする場合

    日本語フォントのインストール手順(手順6)を再度実行し、システムを再起動してください。

    参考情報

     
     
    けもみみもふもふ 冷やしビール始めました

    あなたへのおすすめ