AgentBridge

Exponga las herramientas de su espacio de trabajo de VS Code — archivos, terminal, LSP, diagnósticos e imágenes — a clientes MCP remotos (ChatGPT Connectors, Claude Desktop, Cursor, Cline, Continue) a través de un túnel HTTPS público.

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

Estado

v0.1.0 — primera versión estable. Creada y probada en Windows con VS Code 1.95+ y Node 22+. Las catorce fases de desarrollo están implementadas y verificadas de extremo a extremo con ChatGPT Connectors.

Related MCP server: vscode-mcp-server

Características

• 13 herramientas MCP que abarcan:

  • Sistema de archivos — read_files, apply_patch, search_files, find_files, list_directory, read_image_file

  • Terminal — run_command, get_command_output, send_command_input

  • LSP / diagnósticos — get_diagnostics, lsp

  • Estado del puente — set_todos, report_progress

• 3 proveedores de túneles — Cloudflare Quick Tunnel (predeterminado, sin configuración), Cloudflare Named Tunnel (nombre de host estable), ngrok (dominio reservado).

• 9 shells administrados — Windows PowerShell 5.1, PowerShell 7+, cmd; POSIX bash, zsh, sh, fish. La descripción que se muestra a la IA se actualiza automáticamente al cambiar de shell.

• read_image_file compatible con visión — devuelve bloques ImageContent de MCP (PNG / JPEG / GIF / WebP / BMP) de hasta 5 MiB para que los clientes con capacidad de visión vean los píxeles de forma nativa. SVG permanece como texto a través de read_files.

• Enrutamiento de enlaces externos — agentbridge.bridge.openInternalBrowser (auto / all / external) controla si ChatGPT / Arena abre los enlaces dentro del Navegador Simple de VS Code o en el navegador predeterminado del sistema operativo. El valor predeterminado auto coincide con la experiencia original dentro del editor.

• Panel del puente — Vista en la Barra de Actividades con radio de proveedor de túnel, estado hero, interruptor persistente, línea de tiempo de sesiones con mini diferencias y una tarjeta avanzada que cubre shell administrado, enrutamiento de enlaces, copiar indicación MCP y restablecer routeToken.

• Inicio automático — active agentbridge.bridge.persistentMode para activar el Puente al iniciar la extensión.

• Compatibilidad con clientes — verificado con ChatGPT Connectors, Claude Desktop, Cursor, Cline, Continue.

Instalación

Opción A — Descargar vsix precompilado (recomendado)

La mayoría de los usuarios no necesitan Node.js ni un conjunto de herramientas de compilación. Simplemente descargue el vsix precompilado e instálelo en VS Code.

1. Abra la página de la última versión

2. Descargue agentbridge-0.1.0.vsix en su computadora

3. Instálelo:

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

   O gráficamente: VS Code → Panel de extensiones → menú ⋯ → "Instalar desde VSIX..." → seleccione el archivo descargado.

Opción B — Compilar desde el código fuente (para desarrolladores)

Requiere Node 22+ y npm.

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

Luego ejecútelo como extensión de desarrollo o cargue el vsix empaquetado:

# 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

Opción C — Desde el Marketplace de VS Code (pendiente)

Una vez que se complete el registro del editor, también podrá instalarlo directamente desde el panel de Extensiones buscando "AgentBridge".

Proveedores de túneles

Elija en el panel AgentBridge en el radio de proveedor de túnel, o configure agentbridge.bridge.tunnelProvider en settings.json.

Configuración

Todos los ajustes están bajo el espacio de nombres agentbridge.bridge.*.

Los cambios en tiempo de ejecución para shell administrado y navegador interno se encuentran en la tarjeta avanzada del panel del Puente.

Limitaciones conocidas

• La URL del Quick Tunnel de Cloudflare es efímera — rota en cada reinicio. Use Named Tunnel (o ngrok) para URL estables y compartibles.

• Redes restringidas (教育网 / redes universitarias con cortafuegos estrictos) pueden bloquear el Quick Tunnel. UDP/QUIC suele estar medio bloqueado. Solución alternativa: sobrescribir el transporte con HTTP2/http y una regla de enrutamiento a cloudflare.com en su proxy. Named Tunnel es la solución definitiva a largo plazo.

• El Navegador Simple + inicio de sesión en ChatGPT a veces se encuentra con desafíos administrados de Cloudflare. Varios reintentos suelen resolverlo; si persiste, cambie al navegador del SO mediante agentbridge.bridge.openInternalBrowser: "external".

• ChatGPT Connectors almacena en caché tools/list al inicio de la sesión. Agregar, eliminar o modificar herramientas MCP requiere que el usuario actualice manualmente (o Elimine y vuelva a agregar) el Conector en chatgpt.com → Configuración → Conectores. Solo Detener+Iniciar el Puente no es suficiente.

Compatibilidad

• VS Code 1.95+

• Node 22+

• Verificado en Windows. Los proveedores de shell POSIX resuelven rutas mediante which(1).

Licencia

MIT. Consulte LICENSE para el texto completo.

Partes derivadas de microsoft/vscode están cubiertas por la licencia MIT de ese proyecto. Consulte https://github.com/microsoft/vscode para más detalles.