Browser Control MCP

🚀 ブラウザコントロールMCP

大規模言語モデルクライアント（Claude Desktopなど）がユーザーのローカルブラウザ（Firefox）を制御できるように、ブラウザ拡張とペアになるMCPサーバーです。

🚀 クイックスタート

このMCPサーバーは、大規模言語モデルクライアントと連携して、ユーザーのFirefoxブラウザを制御することができます。以下に、その機能や使用例、インストール方法を説明します。

✨ 主な機能

このMCPサーバーは以下のツールをサポートしています：

• タブの開閉
• 開いているタブのリストの取得
• 開いているタブの並び替え
• ブラウザ履歴の閲覧と検索
• ウェブページの本文内容とリンクの読み取り
• ブラウザタブ内でのテキストの検索とハイライト表示

さらに、開いている各タブの内容はMCPリソースとして利用でき、ユーザーはMCPクライアント（Claudeなど）からブラウザタブを選択し、その内容をロードすることができます。

💻 使用例

タブ管理

• "すべての非業務関連のタブを閉じて。"
• "私のタブを意味のある順序で並べ替えて。"
• "24時間以上アクセスされていないタブを閉じて。"

ブラウザ履歴検索

• "ニュージーランドのミルフォードトレイルに関する記事を見つけて。"
• "過去1週間に閲覧したAIに関する記事をすべて開いて、最大10件表示し、重複を避ける。"

閲覧と調査

• "ブラウザでHackernewsを開き、トップニュースを開いて記事とそのコメントを読む。コメントはこの記事に普遍的に賛同しているか？"
• "Google Scholarを使って、過去3年間のL-テアニンに関する論文をブラウザで検索する。引用数が最も多い3つの論文を開く。読んだ後に要約する。"
• "Google検索エンジンを使って花屋を探す。最も関連性の高い10件の結果を開く。各花屋の位置と営業時間の表を表示する。"

📦 インストール

このリポジトリをクローンし、メインディレクトリで以下のコマンドを実行して、MCPサーバーとブラウザ拡張をビルドします：

npm install
npm install --prefix mcp-server
npm install --prefix firefox-extension
npm run build

最後のnpm run buildコマンドは、MCPサーバーと拡張間の共有キーも生成します。

Claude Desktopとの連携：

以下の設定をclaude_desktop_config.jsonファイルに追加します（Claude Desktopの開発者設定の「設定を編集」ボタンを使用）：

{
    "mcpServers": {
        "browser-control": {
            "command": "node",
            "args": [
                "<パス>/mcp-server/dist/server.js"
            ]
        }
    }
}

<パス>を正しいパスに置き換えてください。

Claude Desktopを再起動することを忘れないでください。

Firefoxとの連携

ブラウザコントロールMCP拡張はFirefox向けに開発されています。

拡張をインストールするには：

1. Firefoxのアドレスバーにabout:debuggingを入力します。
2. 「このFirefox」をクリックします。
3. 「一時的なアドオンを読み込む...」をクリックします。
4. プロジェクトフォルダ内のfirefox-extensionディレクトリのmanifest.jsonファイルを選択します。

個人のFirefoxブラウザで拡張を実行したくない場合は、別のFirefoxインスタンス（Firefox Developer Editionなど、https://www.mozilla.org/en-US/firefox/developer/ からダウンロード）を選択することができます。