Chrome Tools

🚀 Chrome 工具 MCP サーバー

この MCP サーバーは、Chrome の DevTools プロトコルを介したインタラクションを提供するツールです。このサーバーを使用すると、Chrome タブをリモートで制御でき、JavaScript の実行、スクリーンショットの撮影、ネットワークトラフィックの監視などが可能です。

🚀 クイックスタート

この MCP サーバーを使用することで、手動でブラウザを特定の状態に設定した後、AI ツール（Cline など）に操作を行わせることができます。また、このツールを使用して、そのコンテキスト内のネットワークイベントをキャプチャして取得することもできます。

✨ 主な機能

• Chrome タブを一覧表示する
• タブ内で JavaScript を実行する
• スクリーンショットを撮影する
• ネットワークトラフィックを監視する
• タブを URL にナビゲートする
• DOM 要素をクエリする
• 要素をクリックし、コンソール出力をキャプチャする

📦 インストール

npm install @nicholmikey/chrome-tools

📚 ドキュメント

設定

MCP 設定の環境変数を使用して設定します。

{
  "chrome-tools": {
    "command": "node",
    "args": ["path/to/chrome-tools/dist/index.js"],
    "env": {
      "CHROME_DEBUG_URL": "http://localhost:9222",
      "CHROME_CONNECTION_TYPE": "direct",
      "CHROME_ERROR_HELP": "custom error message"
    }
  }
}

環境変数

インストール手順

ローカル環境

1. ターミナルを開き、以下のコマンドを実行します。

   npm install @nicholmikey/chrome-tools
   

2. プロジェクトディレクトリに config.json という名前の設定ファイルを作成し、以下の内容を追加します。

   {
     "chrome-tools": {
       "command": "node",
       "args": ["path/to/chrome-tools/dist/index.js"],
       "env": {
         "CHROME_DEBUG_URL": "http://localhost:9222"
       }
     }
   }
   

3. サーバーを起動します。

   node index.js
   

WSL 環境

1. WSL 内で Node.js と npm をインストールします。
2. chrome-tools パッケージをインストールします。

   npm install @nicholmikey/chrome-tools
   

3. 設定ファイルを作成し、サーバーを起動します。手順はローカル環境と同じです。

Docker 環境

1. 以下の内容を持つ Dockerfile を作成します。

   FROM node:latest
   WORKDIR /app
   COPY package.json .
   RUN npm install
   COPY . .
   CMD ["node", "index.js"]
   

2. Docker イメージをビルドします。

   docker build -t chrome-tools .
   

3. コンテナを実行します。

   docker run --name chrome-tools-container -p 9222:9222 chrome-tools
   

💻 使用例

基本的な使用法

タブを一覧表示する

listTabs()

スクリプトを実行する

executeScript(tabId, script)

スクリーンショットを撮影する

captureScreenshot(tabId)

ネットワークトラフィックを監視する

monitorNetworkTraffic(tabId, duration, filters)

URL にナビゲートする

navigateToUrl(tabId, url)

DOM 要素をクエリする

querySelectorElements(tabId, selector)

要素をクリックする

clickElement(tabId, selector)

📄 ライセンス

MIT