AgentBridge
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.
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: Portal
Funktionen
13 MCP-Werkzeuge in den Bereichen:
Dateisystem –
read_files,apply_patch,search_files,find_files,list_directory,read_image_fileTerminal –
run_command,get_command_output,send_command_inputLSP / Diagnosen –
get_diagnostics,lspBridge-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 überread_filesals 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. Standardautoentspricht 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.
Öffnen Sie die neueste Release-Seite
Laden Sie
agentbridge-0.1.0.vsixauf Ihren Computer herunterInstallieren Sie sie:
code --install-extension /path/to/agentbridge-0.1.0.vsixOder 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 buildFü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.vsixOption 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
Modus | Stabilität der öffentlichen URL | Anforderungen |
| Flüchtig – ändert sich nach jedem Neustart | Keine |
| Stabile Hostname ( | Cloudflare-Konto, verwaltete Domain, Tunnel-Token, veröffentlichte App-Route |
| Reservierte Domain ( | ngrok-Authtoken + reservierte Hostname |
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.*.
Schlüssel | Typ | Standard | Hinweise |
| enum |
|
|
| string |
| Fester Hostname (z. B. |
| integer |
| Lokaler Port, den der Named Tunnel weiterleitet |
| string |
| Reservierte ngrok-Domain (z. B. |
| string |
| Absoluter Pfad (z. B. |
| string |
| Absoluter Pfad oder über PATH auflösbarer Name (z. B. |
| enum |
|
|
| boolean |
| Startet die Bridge automatisch beim Aktivieren der Erweiterung |
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 zucloudflare.comin 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/listbeim Sitzungsstart. Das Hinzufügen / Entfernen / Ändern von MCP-Werkzeugen erfordert, dass der Benutzer den Connector inchatgpt.com → Settings → Connectorsmanuell 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.
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
- QuallaaOAuthcom.quallaa
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
The OpenRouter MCP server plugs OpenRouter into the AI tools you already use. Once connected, your assistant can pull live OpenRouter data (models, prices, your credits, rankings, and docs) and send quick test messages, all without leaving your editor.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceConverts VSCode into an MCP server that enables external clients to remotely execute VSCode internal commands, query workspace information, and interact with the editor through HTTP streaming. Built on the FastMCP framework with security controls and real-time monitoring.63MIT
- AlicenseNot gradedqualityAmaintenanceEnables MCP clients to connect to a local workspace over a public tunnel and lets them run shell commands and transfer files bidirectionally.262 npm21GPL 3.0
- AlicenseNot gradedqualityCmaintenanceBridges web-based AI agents to a local VS Code workspace over MCP Streamable HTTP, letting them inspect files, edit code, and run persistent shell commands within session-scoped boundaries. Risky, destructive, or out-of-scope operations pause for explicit human approval, with session state surviving reconnects.8 npmGPL 3.0
- AlicenseNot gradedqualityAmaintenanceExposes a running VS Code instance to AI agents via MCP, enabling file operations, LSP diagnostics, terminal commands, Git workflows, and refactoring.23MIT