以下に、Puppeteer MCP ServerをClaude Desktopに追加して利用する方法を詳しく解説します。
動画での解説は以下。
手順 1: Puppeteer MCP Serverのインストール
Puppeteer MCP Serverを動作させるには、以下の方法でインストールします。
1.1 Node.jsとnpmが必要
Puppeteer MCP Serverはnpx
を使用するため、事前にNode.jsとnpmがインストールされている必要があります。
以下のコマンドでインストール済みか確認してください
node -v
npm -v
インストールされていない場合は、Node.js公式サイトからインストールしてください。
1.2 Puppeteer MCP Serverのインストール
ターミナルを開き、以下のコマンドを実行してPuppeteer MCP Serverを起動します
npx -y @modelcontextprotocol/server-puppeteer
これでサーバーが起動します。
手順 2: Claude Desktop設定ファイルの編集
Puppeteer MCP ServerをClaude Desktopの設定に追加します。
2.1 設定ファイルを開く
Claude Desktopの設定ファイルは以下の場所にあります
- Mac:
~/Library/Application Support/Claude/claude-desktop-config.json
- Windows:
%AppData%\Claude\claude-desktop-config.json
設定ファイルをテキストエディタ(例: VS Code, Nano)で開きます。
2.2 Puppeteerサーバーを追加
以下の内容をJSONファイルに追加します:
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]
}
}
}
2.3 設定ファイルを保存
JSONファイルの構文エラーがないことを確認し、保存します。
手順 3: Claude Desktopの再起動
- 設定を反映させるため、Claude Desktopアプリを終了して再起動します。
- アプリ内のMCPツール一覧にPuppeteerが追加されていることを確認します。
手順 4: Puppeteer MCP Serverのテスト
Puppeteer MCP Serverが正しく動作しているか確認するために、以下の操作を試してみます。
4.1 簡単なテスト: ページナビゲーション
Claude Desktopのチャット欄に以下のプロンプトを入力します:
指定されたURLにアクセスしてください。URL: https://example.com
4.2 スクリーンショットの取得
ページ全体のスクリーンショットを撮影するには、以下のプロンプトを使用します:
このURLにアクセスしてスクリーンショットを撮影してください。名前はexample_screenshotで保存。URL: https://example.com
4.3 JavaScriptの実行
ブラウザコンソールでJavaScriptを実行するには、以下を入力します:
このページで次のJavaScriptを実行してください: alert('Hello, Puppeteer!');
手順 5: トラブルシューティング
5.1 サーバーが起動しない場合
Node.jsやnpmが正しくインストールされていない場合があります。
Node.jsとnpmのインストール状況を確認し、最新バージョンを使用してください。
権限エラーが発生する場合以下のコマンドを試してください
sudo npx -y @modelcontextprotocol/server-puppeteer
5.2 MCPツール一覧にPuppeteerが表示されない場合
- 設定ファイルのJSON構文を確認します(例: JSONLintを使用)。
- Claude Desktopアプリを再起動してください。
5.3 特定の操作が失敗する場合
サーバーのログを確認します。ターミナルで以下を実行するとログが見られます:
npx @modelcontextprotocol/inspector uvx mcp-server-puppeteer
以上の手順を実行すれば、Puppeteer MCP ServerをClaude Desktopで利用できるようになります。Webページの操作やスクリーンショット撮影、JavaScript実行などが簡単に行えるはずです。問題があれば詳細をお知らせください!