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-puppeteer2. 設定の確認
追加されたMCPサーバーを確認:
claude mcp list以下のように表示されれば成功です:
puppeteer: npx -y @modelcontextprotocol/server-puppeteer3. 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-utils5. Ubuntu 24.04の場合の追加対応
Ubuntu 24.04を使用している場合、以下のコマンドも実行してください:
sudo apt-get install -y libasound2t646. 日本語フォントのインストール
日本語サイトで文字化けを防ぐため、日本語フォントをインストールします:
sudo apt-get install -y fonts-noto-cjk fonts-ipafont fonts-ipaexfont7. インストールの確認
日本語フォントが正しくインストールされたか確認:
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)を再度実行し、システムを再起動してください。