Skip to main content
Glama

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: Portal

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

Modo

Estabilidad de la URL pública

Requisitos

cloudflare (predeterminado)

Efímera — cambia después de cada reinicio

Ninguno

cloudflare-named

Nombre de host estable (mcp.example.com)

Cuenta de Cloudflare, dominio administrado, Token de túnel, ruta de aplicación publicada

ngrok

Dominio reservado (you.ngrok-free.dev)

Authtoken de ngrok + nombre de host reservado

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.*.

Clave

Tipo

Predeterminado

Notas

tunnelProvider

enum

cloudflare

cloudflare / cloudflare-named / ngrok

cloudflareNamedDomain

string

""

Nombre de host fijo (ej. mcp.example.com)

cloudflareNamedLocalPort

integer

48271

Puerto local al que enruta el túnel nombrado

ngrokDomain

string

""

Dominio ngrok reservado (ej. you.ngrok-free.dev)

managedShell.windows

string

""

Ruta absoluta (ej. C:\Program Files\PowerShell\7\pwsh.exe); vacío = Windows PowerShell 5.1 predeterminado

managedShell.unix

string

""

Ruta absoluta o nombre resoluble en PATH (ej. /bin/zsh o bash); vacío = /bin/bash predeterminado (o /bin/sh cuando bash no está disponible)

openInternalBrowser

enum

auto

auto / all / external; controla si los enlaces externos se abren en el Navegador Simple de VS Code o en el navegador predeterminado del SO

persistentMode

boolean

false

Iniciar el Puente automáticamente al activar la extensión

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Converts 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.
    63
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP clients to connect to a local workspace over a public tunnel and lets them run shell commands and transfer files bidirectionally.
    262 npm
    21
    GPL 3.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    Bridges 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 npm
    GPL 3.0