Claude Chrome MCP

Claude Chrome MCP

MCP クライアント（Claude Desktop、Claude Code、Cursor）がChrome拡張機能とMCP サーバーを通じてclaude.aiとやり取りできるブラウザー自動化ツールです。

コンポーネント

• MCP サーバー
• Chrome拡張機能（claude.aiでのみ有効）
• CLIツール

クイックスタート

前提条件

• Google Chromeブラウザー
• Node.js v16以降
• npmがインストールされていること

手順1：Chrome拡張機能をインストールする

1. Chromeを開き、chrome://extensions/に移動します
2. 「デベロッパーモード」を有効にします（右上のトグル）
3. 「パッケージ化されていない拡張機能を読み込む」をクリックし、このプロジェクトのextension/ディレクトリを選択します
4. 拡張機能のアイコンがツールバーに表示されます

手順2：依存関係をインストールする

# From the project root directory
cd mcp-server
npm install

手順3：Claude Desktopを設定する

1. Claude Desktopの設定を開きます
2. Developer > Edit Configに移動します
3. 次の設定を追加します：

{
  "mcpServers": {
    "claude-chrome-mcp": {
      "command": "node",
      "args": ["<absolute-path-to-project>/mcp-server/src/server.js"]
    }
  }
}

<absolute-path-to-project>をこのプロジェクトの絶対パス（例：/Users/yourname/claude-chrome-mcp）に置き換えます

手順4：Claude Desktopを再起動する

設定を追加したら、MCP サーバーを読み込むためにClaude Desktopを再起動します。サーバーはポート54321で組み込みのWebSocketリレーを自動的に起動します。

手順5：接続をテストする

Claude Desktopで、次のような自然言語コマンドを使用できます：

• 「Chromeのステータスを確認して」
• 「新しいタブを開いて」
• 「新しいClaudeタブに『Hello, World!』を送信して」
• 「開いているClaudeタブをすべて一覧表示して」
• 「『math』を含むClaudeのチャットを検索して」

主な機能

• 完了検出機能を備えた非同期メッセージ送信
• ClaudeからClaudeへの応答転送
• Claude.ai APIによる会話管理
• ネットワークの検査およびデバッグツール
• 持続的な接続を使用するWebSocket専用アーキテクチャ
• リレーのステータスを確認するヘルスモニタリングエンドポイント

ドキュメント

ガイド	説明
アーキテクチャ分析	重大な問題と改善ロードマップ
アーキテクチャ	システム設計とコンポーネント
トラブルシューティング	トラブルシューティングとタイムアウト解決の完全ガイド
開発ワークフロー	コードの変更、テスト、開発手順
TypeScript	型定義と開発
CLIツール	コマンドラインインターフェースとセットアップ
イベントアーキテクチャ	システム図

プロジェクトリソース

• MCP設定 - クイックコマンドとセットアップ
• GitHubリリース - リリース履歴
• GitHub Issueスクリプト - Claude Code統合ユーティリティ

CLIツール（任意）

npm install && npm run build && npm link

アーキテクチャ

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Claude.ai     │    │ Chrome Extension │    │ WebSocket Relay │
│   (Browser)     │◄──►┤ (Offscreen Doc)  │◄──►│   Port 54321    │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                                         ▲
                                                         │
                                                ┌────────┴────────┐
                                                │                 │
                                        ┌───────▼──────┐ ┌───────▼──────┐
                                        │ MCP Server   │ │ Claude Code  │
                                        │ (Relay Mode) │ │ MCP Client   │
                                        └──────────────┘ └──────────────┘