AgentBridge

Machen Sie die Werkzeuge Ihres VS Code-Arbeitsbereichs – Dateien, Terminal, LSP, Diagnosen und Bilder – für entfernte MCP-Clients (ChatGPT Connectors, Claude Desktop, Cursor, Cline, Continue) über einen öffentlichen HTTPS-Tunnel verfügbar.

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

Status

v0.1.0 – erste stabile Version. Erstellt und getestet unter Windows mit VS Code 1.95+ und Node 22+. Alle vierzehn Entwicklungsphasen sind abgeschlossen und Ende-zu-Ende gegen ChatGPT Connectors verifiziert.

Related MCP server: vscode-mcp-server

Funktionen

• 13 MCP-Werkzeuge in den Bereichen:

  • Dateisystem – read_files, apply_patch, search_files, find_files, list_directory, read_image_file

  • Terminal – run_command, get_command_output, send_command_input

  • LSP / Diagnosen – get_diagnostics, lsp

  • Bridge-Zustand – set_todos, report_progress

• 3 Tunnel-Anbieter – Cloudflare Quick Tunnel (Standard, keine Konfiguration), Cloudflare Named Tunnel (stabiler Hostname), ngrok (reservierte Domain).

• 9 verwaltete Shells – Windows PowerShell 5.1, PowerShell 7+, cmd; POSIX bash, zsh, sh, fish. Die dem KI-Assistenten angezeigte Beschreibung aktualisiert sich automatisch beim Wechsel der Shell.

• Bildfähiges read_image_file – gibt MCP-ImageContent-Blöcke (PNG / JPEG / GIF / WebP / BMP) bis zu 5 MiB zurück, sodass bildfähige Clients Pixel nativ sehen. SVG bleibt über read_files als Text erhalten.

• Externe Link-Routing – agentbridge.bridge.openInternalBrowser (auto / all / external) steuert, ob ChatGPT / Arena innerhalb des VS Code Simple Browser oder im Standard-Browser des Betriebssystems geöffnet werden. Standard auto entspricht der ursprünglichen Erfahrung im Editor.

• Bridge-Panel – Ansicht in der Aktivitätsleiste mit Tunnel-Anbieter-Auswahl, Status-Hero, dauerhaftem Ein-/Ausschalter, Sitzungsverlauf mit Mini-Diffs sowie einer erweiterten Karte für verwaltete Shell, Link-Routing, MCP-Prompt kopieren und routeToken zurücksetzen.

• Autostart – Setzen Sie agentbridge.bridge.persistentMode, um die Bridge beim Aktivieren der Erweiterung zu starten.

• Client-Kompatibilität – Verifiziert gegen ChatGPT Connectors, Claude Desktop, Cursor, Cline, Continue.

Installation

Option A – Vorgebaute vsix herunterladen (empfohlen)

Die meisten Benutzer benötigen weder Node.js noch eine Build-Toolchain. Laden Sie einfach die vorgebaute vsix herunter und installieren Sie sie in VS Code.

1. Öffnen Sie die neueste Release-Seite

2. Laden Sie agentbridge-0.1.0.vsix auf Ihren Computer herunter

3. Installieren Sie sie:

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

   Oder grafisch: VS Code → Erweiterungen-Panel → ⋯-Menü → „Install from VSIX…“ → die heruntergeladene Datei auswählen.

Option B – Aus dem Quellcode erstellen (für Entwickler)

Erfordert Node 22+ und npm.

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

Führen Sie sie dann entweder als Dev-Erweiterung aus oder laden Sie die gepackte vsix nach:

# 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

Option C – Aus dem VS Code Marketplace (ausstehend)

Sobald die Herausgeberregistrierung abgeschlossen ist, können Sie sie auch direkt über das Erweiterungen-Panel durchsuchen und installieren, indem Sie nach „AgentBridge“ suchen.

Tunnel-Anbieter

Wählen Sie im AgentBridge-Panel die Tunnel-Anbieter-Auswahl oder setzen Sie agentbridge.bridge.tunnelProvider in settings.json.

Konfiguration

Alle Einstellungen befinden sich unter dem Namespace agentbridge.bridge.*.

Laufzeit-Umschalter für verwaltete Shell und internen Browser befinden sich auf der erweiterten Karte des Bridge-Panels.

Bekannte Einschränkungen

• Cloudflare Quick Tunnel URL ist flüchtig – wechselt bei jedem Neustart. Verwenden Sie Named Tunnel (oder ngrok) für stabile, teilbare URLs.

• Eingeschränkte Netzwerke (教育网 / strenge Firewall-Campusnetzwerke) können Quick Tunnel aufhängen. UDP/QUIC ist oft halb blockiert. Umgehen Sie dies mit einem HTTP2/http-Transport-Override und einer Routing-Regel zu cloudflare.com in Ihrem Proxy. Named Tunnel ist die langfristige Lösung.

• Simple Browser + ChatGPT-Login stößt manchmal auf Cloudflare Managed Challenges. Mehrfachwiederholung löst das Problem meist; falls es bestehen bleibt, wechseln Sie zum Betriebssystem-Browser über agentbridge.bridge.openInternalBrowser: "external".

• ChatGPT Connectors cacht tools/list beim Sitzungsstart. Das Hinzufügen / Entfernen / Ändern von MCP-Werkzeugen erfordert, dass der Benutzer den Connector in chatgpt.com → Settings → Connectors manuell aktualisiert (oder entfernt und neu hinzufügt). Stopp+Start der Bridge allein reicht nicht.

Kompatibilität

• VS Code 1.95+

• Node 22+

• Verifiziert unter Windows. POSIX-Shell-Anbieter lösen Pfade über which(1) auf.

Lizenz

MIT. Siehe LICENSE für den vollständigen Text.

Teile, die von microsoft/vscode abgeleitet sind, unterliegen der MIT-Lizenz dieses Projekts. Siehe https://github.com/microsoft/vscode für Details.