Browser Control MCP

Browser Control MCP

AI アシスタントがタブ管理、閲覧履歴、ウェブページのテキストコンテンツにアクセスできるようにする、Firefox ブラウザー拡張機能と連携した MCP サーバーです。

機能

MCP サーバーは、以下のツールに対応しています。

• タブを開く、または閉じる
• 開いているタブの一覧を取得する
• 名前と色を指定してタブグループを作成する
• 開いているタブの順序を変更する
• ブラウザーの履歴を読み取り、検索する
• ウェブページのテキストコンテンツとリンクを読み取る（ユーザーの同意が必要です）
• ブラウザーのタブ内のテキストを検索して強調表示する（ユーザーの同意が必要です）
• タブの表示領域のスクリーンショットを撮影する（タブごとにユーザーの同意が必要です）

使用例：

タブ管理

• 「ブラウザーで仕事に関係のないタブをすべて閉じてください。」
• 「ブラウザーで開いている開発関連のタブをすべて、『Development』という新しいグループにまとめてください。」
• 「ブラウザーのタブを、分かりやすい順序に並べ替えてください。」
• 「過去24時間以内にアクセスしていないタブを、ブラウザーですべて閉じてください。」

閲覧履歴の検索

• 「ブラウザーの履歴から、NZ の Milford Track に関する記事を探してください。」
• 「過去1週間にアクセスした AI 関連の記事を、重複を避けて最大10件開いてください。」

閲覧と調査

• 「ブラウザーで hackernews を開き、トップ記事を開いて読んでください。コメントも読んで、コメントの内容が記事に賛同しているか教えてください。」
• 「ブラウザーで Google Scholar を使い、過去3年間の L-テアニンに関する論文を検索してください。最も引用数の多い論文を3件開いて読み、要約してください。」
• 「ブラウザーで Google 検索を使って花屋を探してください。関連性の高い結果を10件開き、各花屋の場所と営業時間をまとめた表を見せてください。」

ウェブ自動化 MCP サーバーとの比較

この MCP サーバーと Firefox 拡張機能の組み合わせは、ユーザーの個人用ブラウザーをより安全に利用できるよう、ウェブ自動化 MCP サーバーよりも安全性を高める設計になっています。

• ウェブページの変更、ページ上での操作、任意のスクリプト実行には対応していません。
• ウェブページのコンテンツを読み取るには、ドメインごとにブラウザーでユーザーが明示的に同意する必要があります。これは拡張機能のマニフェストレベルで適用されます。
• スクリーンショットを撮影するには、ユーザーが拡張機能のツールバーボタンをクリックして、個々のタブを許可する必要があります。この拡張機能では activeTab 権限を使用するため、許可は Firefox 自体によって適用され、タブの移動または終了時に失効します。スクリーンショットのために、拡張機能が広範なホスト権限を要求することはありません。
• MCP サーバーと拡張機能の間では、共有シークレットを使用したローカル接続のみを利用します。
• リモートでのデータ収集やトラッキングはありません。
• ツール呼び出しの監査ログと、ツールの有効化・無効化設定を拡張機能側に備えています。
• 拡張機能に実行時のサードパーティ依存関係はありません。

重要な注意事項：Browser Control MCP はまだ実験段階です。ご自身の責任でご使用ください。他の MCP サーバーと同様に慎重に扱い、ツール呼び出しは注意深く許可し、監視してください。

インストール

オプション 1：Firefox 拡張機能と Claude Desktop 拡張機能をインストールする

Firefox 拡張機能／アドオンはaddons.mozilla.org で入手できます。この GitHub リポジトリから、最新のビルド済みバージョンをダウンロードして開くこともできます：browser-control-mcp-1.5.0.xpi。インストール後に自動的に開く「拡張機能の管理」ページの手順に従って、インストールを完了してください。

アドオンの「拡張機能の管理」ページには、Claude Desktop の DXT ファイルへのリンクが表示されます。こちらからダウンロードすることもできます：mcp-server-v1.5.2.dxt。ファイルをダウンロードしたら、Claude Desktop の設定ウィンドウで開くか、ウィンドウにドラッグしてください。インストール後、必ず DXT 拡張機能を有効にしてください。これは Claude Desktop の最新バージョンでのみ動作します。MCP サーバーをローカルにインストールする場合は、以下の MCP 設定をご覧ください。

オプション 2：コードからビルドする

コードからビルドするには、このリポジトリをクローンし、メインリポジトリのディレクトリで以下のコマンドを実行して、MCP サーバーとブラウザー拡張機能の両方をビルドします。

npm install
npm run build

Firefox の一時的なアドオンをインストールする

Firefox に一時的なアドオンとして拡張機能をインストールするには：

1. Firefox の URL バーに about:debugging と入力します
2. 「この Firefox」をクリックします
3. 「一時的なアドオンを読み込む…」をクリックします
4. このプロジェクトの firefox-extension フォルダーにある manifest.json ファイルを選択します
5. 拡張機能の設定ページが開きます。シークレットキーをクリップボードにコピーしてください。これは MCP サーバーの設定に使用します。

または、恒久的なアドオンをインストールするには、addons.mozilla.org の Browser Control MCPをインストールしてから、以下の手順に従って MCP サーバーを設定します。

個人用の Firefox ブラウザーで拡張機能を実行したくない場合は、別の Firefox インスタンス（https://www.mozilla.org/en-US/firefox/developer/ から入手できる Firefox Developer Edition など）をダウンロードする方法もあります。

MCP サーバーの設定

ブラウザー拡張機能をインストールしたら、mcpServers の設定に以下の設定を追加します（例：Claude Desktop の場合は claude_desktop_config.json）：

{
    "mcpServers": {
        "browser-control": {
            "command": "node",
            "args": [
                "/path/to/repo/mcp-server/dist/server.js"
            ],
            "env": {
                "EXTENSION_SECRET": "<secret_on_firefox_extension_options_page>",
                "EXTENSION_PORT": "8089" 
            }
        }
    }
}

/path/to/repo を正しいパスに置き換えてください。

EXTENSION_SECRET に、Firefox の拡張機能設定ページに表示されている値を設定します（about:addons からアクセスできます）。EXTENSION_PORT 環境変数を設定して、MCP サーバーが拡張機能との通信に使用するポートを指定することもできます（デフォルトは 8089 です）。

MCP サーバーが拡張機能に接続するまで、数秒かかる場合があります。

Docker で MCP サーバーを設定する

または、Docker ベースの設定を使用できます。その場合は、mcp-server の Docker イメージをビルドします：

docker build -t browser-control-mcp .

次に、以下の mcpServers 設定を使用します：

{
    "mcpServers": {
        "browser-control": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-p", "127.0.0.1:8089:8089",
                "-e", "EXTENSION_SECRET=<secret_from_extension>",
                "-e", "CONTAINERIZED=true",
                "browser-control-mcp"
            ]
        }
    }
}