Agentic Tab Organizer MCP

MCP互換のAIエージェントを、Chromiumベースのブラウザのライブタブに接続します。エージェントは、タブの一覧表示、選択したページコンテンツの読み取り、整理プランのプレビュー、保持したタブを重複排除された1つのウィンドウへの統合ができます。

このオーガナイザーにはAIモデルは含まれておらず、AI APIキーも必要ありません。お使いのMCPクライアントは、既存のモデル認証を使用します。StdioおよびスタンドアロンHTTP接続では、拡張機能が表示するローカルペアリングトークンを使用します。このトークンがマシンの外部に出ることはありません。

機能

• 通常のブラウザウィンドウすべてから、タイトル、URL、グループ、タブ状態を含むタブを一覧表示します

• 選択したHTTPおよびHTTPSタブから、上限付きの読み取り可能なテキストを抽出します

• 完全一致ドメインまたは明示的なタブIDでタブを閉じます（サブドメイン一致はオプション）

• 正規化されたURLの完全一致を重複排除し、優先コピーを保持します

• 明示的に許可されない限り、整理時および任意のクローズ時にピン留めタブを保持します

• ブラウザを変更する前に、順序付けられたカテゴリをプレビューおよび検証します

• 表示可能なタブグループを持つ1つの宛先ウィンドウ、または左から右に並ぶ1つのフラットなタブストリップを作成します

• 重複を閉じる前に、保持するタブを並べ替えて検証します

• 標準のMCP stdioまたはローカルStreamable HTTPで接続します

Related MCP server: ChromeWire MCP

要件

• Brave Browser、Google Chrome、またはその他の互換性のあるChromiumブラウザ

• Node.js 20以降

• OpenCode、Claude Desktop、Cursor、またはその他のMCPクライアントなどのMCP互換エージェント

開発と実際のブラウザでの検証は、主にBraveで行われています。Chromeおよび関連するChromiumブラウザは同じ拡張機能APIを使用しており、動作すると期待されていますが、現在は同じエンドツーエンドのテストカバレッジはありません。

ビルド

Braveのbrave://extensionsまたはChromeのchrome://extensionsを開き、デベロッパー モードを有効にし、パッケージ化されていない拡張機能を読み込むを選択して、このリポジトリのdistディレクトリを選択してください。

npx pnpm@11.24.0 install
npx pnpm@11.24.0 run build

拡張機能のポップアップを開き、ローカルペアリングトークンをコピーしてください。

エージェントを接続する

Stdio

Stdioは最も簡単なオプションです。MCPクライアントにdist-node/mcp-stdio.cjsの絶対パスを設定してください：

{
  "mcpServers": {
    "agentic-tabs": {
      "command": "/absolute/path/to/agentic-tab-organizer/dist-node/mcp-stdio.cjs",
      "env": {
        "AGENTIC_TABS_BRIDGE_TOKEN": "TOKEN_FROM_EXTENSION_POPUP"
      }
    }
  }
}

エージェントプロセスは、localhost限定のブラウザブリッジを開きます。拡張機能は自動的に再接続します。

Streamable HTTP

永続的なローカルサーバーを起動します：

AGENTIC_TABS_BRIDGE_TOKEN="TOKEN_FROM_EXTENSION_POPUP" npx pnpm@11.24.0 run mcp:http

MCPクライアントを次のように設定します：

http://127.0.0.1:32145/mcp

stdioモードとHTTPモードは同じローカルブラウザブリッジポートを使用するため、同時に実行しないでください。

Native Messaging

Native MessagingはmacOSおよびLinuxではオプションです。インストーラはGoogle Chrome、Brave、Chromiumに対して同じホストを登録します：

npx pnpm@11.24.0 run install:host

拡張機能を再読み込みすると、ブラウザはローカルHTTP MCPホストを自動的に起動します。HTTP MCPクライアントをhttp://127.0.0.1:32145/mcpに接続してください。

エージェントのワークフロー

MCPは5つのツールを公開しています：

リクエスト例：

すべてのブラウザタブを調べてください。必要に応じてあいまいなページを要約し、それらを仕事、読書、ソーシャル、開発、その他にグループ化して、プランをプレビューしてください。承認後、重複排除された1つのウィンドウに統合してください。

amazon.nlの開いているタブをすべて閉じてください。

browser_plan_organizationはcreateGroupsを受け付け、デフォルトはtrueです。これをfalseに設定すると、カテゴリの順序を左から右への配置にのみ使用します。ピン留めされたタブが最初に残り、その後、指定された順序で各カテゴリが続き、宛先ウィンドウには表示可能なタブグループはありません。

すべてのウィンドウを重複排除された1つのウィンドウに統合してください。タブグループは作成せず、代わりにカテゴリを左から右に並べてください。

安全性とプライバシー

• プランニングはブラウザを変更しません。

• 適用時、プランニング後にタブ、URL、ウィンドウ、ピン状態、順序、またはグループが変更された場合、適用は中止されます。

• 重複タブは、保持されたタブが宛先ウィンドウで検証された後にのみ閉じられます。

• browser_close_tabsは、amazon.nlのような完全一致ドメイン、またはbrowser_list_tabsが返す明示的なIDに対応しています。先頭のwwwは正規化され、サブドメインには明示的なオプトインが必要です。

• 何かを閉じる前に、拡張機能は、選択されたすべてのタブがMCPサーバーによって観測されたURLをまだ保持していることを検証します。その間にタブが移動した場合、クローズ操作全体が中止されます。

• ピン留めされたタブはデフォルトでスキップされ、skippedTabsに表示されます。これらを閉じるにはallowPinned: trueが必要です。

• 整理操作と任意のクローズ操作は1つのミューテーションロックを共有し、ブラウザを同時に変更することを防ぎます。

• シークレットモードでのアクセスは無効です。

• ローカルWebSocketブリッジは127.0.0.1にのみバインドされ、拡張機能の固定オリジンのみを受け入れます。

• 拡張機能とローカルMCPプロセスは、チャレンジレスポンスHMACで相互認証します。ペアリングトークンは送信されることはありません。

• ページコンテンツは、エージェントがbrowser_get_tab_contentを呼び出した場合にのみ返されます。

• brave://やchrome://などの保護されたブラウザページは読み取ることができませんが、一覧表示と移動は可能です。

• エージェントに返されたコンテンツは、そのエージェントの設定済みモデルプロバイダーに送信される場合があります。

開発

npx pnpm@11.24.0 run typecheck
npx pnpm@11.24.0 run test:unit
npx pnpm@11.24.0 run test:integration
npx pnpm@11.24.0 run test:e2e
npx pnpm@11.24.0 run build

エンドツーエンドのテストスイートは、使い捨てプロファイルでBraveを起動し、ユーザーの通常のブラウザプロファイルには一切触れません。Braveが主な検証ブラウザです。Chrome互換性は、共有のChromium拡張機能APIとブラウザに依存しない統合パスに基づいています。