mcp-session-bridge

Name: mcp-session-bridge
Author: t3ratech

ローカル

t3ratech.github.ioブラウザ自動化24 週間前に更新

リポジトリ公式サイト

mcp-session-bridge について

mcp-session-bridgeは、T3rnel Browser拡張機能または独立した永続CDPブラウザーでブラウザーセッションを自動化するMCPサーバーです。ログイン済みブラウザーのページ情報や操作を必要とし、セッションCookieをリモートブラウザーへ送らないMCPクライアント向けです。

主な機能

01ログイン済みブラウザータブの自動操作
02独立した永続CDPブラウザーモード
03ページ情報、フォーム、スナップショット、スクリーンショットの取得
04ローカルリレー経由の拡張機能呼び出し

活用シーン

01ログイン済みブラウザーのページ内容の確認
02ブラウザーでのフォーム入力の自動化
03拡張機能なしでのブラウザー自動化

MCP 対応

stdioでMCPと`session_*`ツールを提供します。T3rnel Browser拡張機能経由で要求を転送するか、独立したCDPブラウザーを操作します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "t3ratech-mcp-session-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@t3ratech/mcp-session-bridge"
      ],
      "env": {
        "T3RNEL_SESSION_MODE": "<T3RNEL_SESSION_MODE>",
        "T3RNEL_SESSION_HEADLESS": "<T3RNEL_SESSION_HEADLESS>",
        "T3RNEL_SESSION_TIMEOUT_MS": "<T3RNEL_SESSION_TIMEOUT_MS>"
      }
    }
  }
}

起動コマンドnpx -y @t3ratech/mcp-session-bridge

設定が必要な環境変数

T3RNEL_SESSION_MODEauto (default) uses the extension when its relay socket exists and falls back to a standalone browser; extension forces the extension; standalone forces its own browser.

T3RNEL_SESSION_HEADLESSSet to 1 to run the standalone browser headless. Ignored in extension mode.

T3RNEL_SESSION_TIMEOUT_MSHow long a single tool call may take before it fails rather than hanging the client.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@t3ratech/mcp-session-bridge1.2.0stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

MCP セッションブリッジ

ユーザー自身の Chrome プロファイルと実際にログイン済みのセッションで動作する、認証済みブラウザーセッションの自動化機能（session_* ツール）を提供する、無料の MCP（Model Context Protocol）サーバーです。この機能はクラウドブラウザー API では実現できません。無料のスタンドアロンモードも利用できます。専用の自動化ブラウザーを起動するため、拡張機能やライセンスなしで同じ session_* ツールを使用できます。

できること

Model Context Protocol に対応するあらゆるクライアントに、stdio（改行区切りの JSON-RPC）で MCP を提供します。セットアップガイドでは、一般的なクライアントを紹介しています。
デュアルトランスポート方式を採用しています。
- 拡張機能モード（無料。Pro ツールは拡張機能によって制限されます） — ローカルの所有者専用リレーソケットを介して、Chrome が起動するネイティブメッセージングホストに呼び出しを転送し、そこから T3rnel Browser 拡張機能に転送します。拡張機能は、実際に認証済みのタブ上で呼び出しを実行します。
- スタンドアロンモード（無料） — 永続プロファイル上で、ヘッドフルまたはヘッドレスの CDP ブラウザーを起動し、直接操作します。ライセンスも拡張機能も不要で、ユーザーが日常的に使うブラウザーにはアクセスしません。
セッション Cookie をリモートブラウザーに送信することなく、構造化されたページコンテキスト、フォーム値、スナップショット、スクリーンショットを返します。

価格

ブリッジ自体は無料で、このパッケージに独自のライセンス要件はありません。

拡張機能モードでは、T3rnel Browser 拡張機能を通じて購入者の実際の認証済みセッションにアクセスできます。このモードが提供する Pro ツールは、拡張機能独自の Pro プランによって制限されます（1 回限り $29.99、3 台のデバイス）。スタンドアロンモードは無料で、拡張機能もライセンスも必要ありません。このパッケージには別途サブスクリプションはなく、サブスクリプションの有無を確認する機能もありません。このファイルの以前の草案では月額 $9 と月額 $39 のプランを案内していましたが、これらは実装されず、適用も購入もできませんでした。

プロジェクト構成

src/server.js — MCP stdio サーバー：ツールの提供、スキーマ検証、デュアルトランスポートのルーティング、再接続とタイムアウトに対応したリレークライアント、スタンドアロン CDP 起動処理。
src/cdp.js — スタンドアロン CDP ブラウザーの管理と WebSocket クライアント。
src/native-host.js — Chrome が起動するネイティブメッセージングホスト。リレーソケットを管理し、複数の MCP サーバーを多重化します。
src/framing.js — ネイティブメッセージングとリレーソケットで共有する、4 バイト長プレフィックス付き JSON フレーミング。
src/tools.js — session_* ツールの定義と検証、および拡張機能の browser_* ツールへのマッピング。
src/license.js — 拡張機能とテストで使用する、オフライン Ed25519 ライセンス検証ヘルパー。
src/install.js — Chrome、Chromium、Brave、Edge 向けの --install / --uninstall ネイティブホスト登録。
docs/setup-guide.md — 一般的な MCP クライアントへのインストール方法、検証、トラブルシューティング。
docs/chrome-validation-checklist.md — T3rnel Browser 拡張機能を使った Chrome のエンドツーエンド検証手順。
ads/ — MCPize、Smithery、mcp.so、PulseMCP への登録時に共用する、見出しと説明文のコピーを収めた ad-copy.md。
tests/ — node --test テストスイート。実際のリレーソケットとネイティブメッセージングのフレーミングを使ったエンドツーエンドテスト、およびスタンドアロンモードのテストを含みます。

ブラウザーのサポート

拡張機能モードでは T3rnel Browser 拡張機能が必要です。この拡張機能は Chrome、Brave、 Edge、Opera、Chromium、Firefox 向けにパッケージ化されており、各ブラウザーの拡張機能ストアから提供されています。Brave と Chromium は Chrome ウェブストアからインストールします。Edge、Opera、Firefox にはそれぞれ別のパッケージがあります。Opera はサイドパネル API を実装しておらず、Firefox はデバッガー API を実装していないため、どちらも一部のみサポートされています。拡張機能のマニフェストジェネレーターには、それぞれの環境で利用できない機能が記載されています。スタンドアロンモードにはブラウザーの要件は一切なく、独自の CDP ブラウザーを起動します。

拡張機能が公開するブラウザーツールは最大 100 個で、ブリッジ独自のセットアップツール session_install も含まれます。統合後のリストが 100 個を超える場合（Google Antigravity はインストールを拒否します）、ブリッジは価値が最も低い動詞 2 つ（session_md_diff、session_check_spelling）を除外し、公開されるリストがすべての拡張機能ビルドで上限以下に収まるようにします。除外されたツールも名前を指定して呼び出せば実行されます。すべてのツールには、拡張機能の Pro による制限と承認ゲートが適用されます。

サポート対象のクライアント

Claude Code / Claude Cowork
Cursor
VS Code
Windsurf / Devin Desktop
Google Antigravity
IntelliJ
Codex
Grok Build
Kimi Code / Kimi Desktop
JCode
Cline
OpenCode
Continue.dev
KiloCode
Roo Code
Aider
OpenClaw
Hermes
OpenFang
MCP stdio に対応するすべてのクライアント

T3rnel Browser 拡張機能をインストールする

このブリッジは、すでにサインインしているブラウザーを AI が操作できる T3rnel Browser 拡張機能と組み合わせると、最も効果的に動作します。

https://browser.t3ratech.co.zw/

掲載先

ライセンス

Apache License, Version 2.0 のもとでライセンスされています。全文は LICENSE をご覧ください。

公開されている npm パッケージは、商用・非商用を問わず、あらゆる目的で無料で使用できます。このソースコードの閲覧と変更が可能です。再配布には Apache-2.0 の条項が適用されます。

Markdown 対応

ログインしてコメント

基本情報

作者: t3ratech
言語: node
バージョン: 1.2.0
トランスポート: stdio
掲載日: 2026年9月5日
最終更新: 4 週間前
公式 Registry: io.github.t3ratech/mcp-session-bridge

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

mcp-session-bridge

mcp-session-bridge について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

MCP セッションブリッジ

できること

価格

プロジェクト構成

ブラウザーのサポート

サポート対象のクライアント

T3rnel Browser 拡張機能をインストールする

掲載先

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？