AgentBridge

VS Code ワークスペースのツール（ファイル、ターミナル、LSP、診断、画像）を、公開HTTPSトンネル経由でリモートMCPクライアント（ChatGPT Connectors、Claude Desktop、Cursor、Cline、Continue）に公開します。

中文文档 | README.zh-CN.md

ステータス

v0.1.0 — 初の安定版リリース。 Windows上のVS Code 1.95+およびNode 22+でビルド・テスト済み。全14の開発フェーズを完了し、ChatGPT Connectorsとのエンドツーエンド検証を実施済み。

Related MCP server: vscode-mcp-server

機能

• 13のMCPツール 以下を含む：

  • ファイルシステム — read_files、apply_patch、search_files、find_files、list_directory、read_image_file

  • ターミナル — run_command、get_command_output、send_command_input

  • LSP / 診断 — get_diagnostics、lsp

  • ブリッジ状態 — set_todos、report_progress

• 3つのトンネルプロバイダー — Cloudflare Quick Tunnel（デフォルト、設定不要）、Cloudflare Named Tunnel（安定したホスト名）、ngrok（予約済みドメイン）。

• 9つの管理シェル — Windows PowerShell 5.1、PowerShell 7+、cmd。POSIX bash、zsh、sh、fish。シェルを切り替えると、AIに表示される説明が自動的に更新されます。

• ビジョン対応の read_image_file — MCP ImageContent ブロック（PNG / JPEG / GIF / WebP / BMP、最大5 MiB）を返すため、ビジョン対応クライアントはピクセルをネイティブに認識できます。SVGは read_files 経由でテキストのまま保持されます。

• 外部リンクルーティング — agentbridge.bridge.openInternalBrowser（auto / all / external）で、ChatGPT / Arena がVS CodeのSimple Browser内で開くか、OSのデフォルトブラウザで開くかを制御します。デフォルトの auto は元のエディタ内エクスペリエンスと一致します。

• ブリッジパネル — アクティビティバービュー。トンネルプロバイダーのラジオボタン、ステータスヒーロー、永続トグル、ミニ差分付きセッションタイムライン、管理シェル・リンクルーティング・MCPプロンプトコピー・routeTokenリセットをカバーする詳細カード。

• 自動起動 — agentbridge.bridge.persistentMode をオンにすると、拡張機能のアクティベーション時にブリッジが起動します。

• クライアント互換性 — ChatGPT Connectors、Claude Desktop、Cursor、Cline、Continue で検証済み。

インストール

オプションA — プリビルドvsixをダウンロード（推奨）

ほとんどのユーザーはNode.jsやビルドツールチェーンを必要としません。プリビルドのvsixを入手してVS Codeにインストールするだけです。

1. 最新リリースページ を開く

2. agentbridge-0.1.0.vsix をコンピュータにダウンロードする

3. インストールする：

   code --install-extension /path/to/agentbridge-0.1.0.vsix

   またはGUIで：VS Code → 拡張機能パネル → ⋯ メニュー → 「VSIXからインストール...」 → ダウンロードしたファイルを選択。

オプションB — ソースからビルド（開発者向け）

Node 22+ と npm が必要です。

git clone https://github.com/5258MF/AgentBridge.git
cd AgentBridge
npm install
npm run build

その後、開発拡張機能として実行するか、パッケージ化されたvsixをサイドロードします：

# Dev mode
"Code.exe" --extensionDevelopmentPath="$PWD"

# Or package a vsix locally
npx @vscode/vsce package --skip-license --allow-missing-repository
code --install-extension agentbridge-0.1.0.vsix

オプションC — VS Code Marketplaceから（準備中）

パブリッシャー登録が完了次第、拡張機能パネルで「AgentBridge」を検索して直接インストールできるようになります。

トンネルプロバイダー

AgentBridge パネルのトンネルプロバイダーラジオボタンで選択するか、settings.json で agentbridge.bridge.tunnelProvider を設定します。

設定

すべての設定は agentbridge.bridge.* 名前空間の下にあります。

管理シェルと内部ブラウザで開く設定のランタイムトグルは、ブリッジパネルの詳細カードにあります。

既知の制限事項

• Cloudflare Quick Tunnel URLは一時的 — 再起動のたびに変わります。安定した共有可能なURLにはNamed Tunnel（またはngrok）を使用してください。

• 制限されたネットワーク（教育網 / 厳格なファイアウォールのキャンパスネットワーク）ではQuick Tunnelがハングする可能性があります。 UDP/QUICが部分的にブロックされることがよくあります。回避策として、HTTP2/http トランスポートのオーバーライドと、プロキシ内の cloudflare.com へのルーティングルールを使用してください。Named Tunnelが長期的な修正策です。

• Simple Browser + ChatGPTログインで、Cloudflareの管理チャレンジに遭遇することがあります。 複数回のリトライで通常は解決します。解決しない場合は、agentbridge.bridge.openInternalBrowser: "external" でOSブラウザに切り替えてください。

• ChatGPT Connectorsはセッション開始時に tools/list をキャッシュします。 MCPツールの追加・削除・変更には、ユーザーが chatgpt.com → 設定 → Connectors で手動でConnectorを更新（または削除して再追加）する必要があります。ブリッジの停止+開始だけでは不十分です。

互換性

• VS Code 1.95+

• Node 22+

• Windowsで検証済み。POSIXシェルプロバイダーは which(1) 経由でパスを解決します。

ライセンス

MIT。全文は LICENSE を参照してください。

microsoft/vscode から派生した部分は、同プロジェクトのMITライセンスの対象となります。詳細は https://github.com/microsoft/vscode を参照してください。