LocalBridge

LocalBridge es una aplicación de puente MCP local para Windows 11 x64, diseñada para que clientes MCP como ChatGPT accedan al área de trabajo de desarrollo local dentro de los límites autorizados explícitamente por el usuario, ejecuten tareas de desarrollo y, cuando sea necesario, realicen operaciones de administrador a través de una ruta independiente de UAC/Broker.

Estructura de herramientas

La API de agente pública de LocalBridge mantiene 8 herramientas principales ordinarias + 1 extensión privilegiada:

• workspace_context: descubrimiento del área de trabajo, los proyectos, el entorno de ejecución y el estado de permisos.

• agent_workflow: orquestación de diagnóstico, reparación, funciones, refactorización, pruebas, compilación, documentación y recuperación.

• exec_command: ejecución de comandos/procesos ordinarios restringida por el modo de permisos.

• command_control: poll / read / write / kill de comandos en ejecución.

• task_control: get / cancel de la tarea de alto nivel actual.

• git_workflow: Git status / log / show / diff / blame.

• document_workflow: lectura y generación controladas de documentos.

• view_image: lectura y escalado controlados de imágenes.

• elevated_exec: extensión privilegiada; solo se puede ejecutar la ruta de administrador en modo administrador y cuando el Broker ha sido autorizado por el usuario mediante UAC.

Related MCP server: bridge-mcp

Modos de permisos

Modo edición solo permite operaciones estructuradas de archivos, Git, edición, etc. dentro del área de trabajo activa; no permite iniciar Shell/procesos ordinarios.

Modo completo permite cmd, PowerShell y procesos de desarrollo, pero los procesos utilizan siempre el token de usuario ordinario actual de Windows. Las rutas estructuradas, el workdir, Git, los documentos, las imágenes y las entradas de edición de LocalBridge siguen limitados al área de trabajo activa; LocalBridge no ofrece una sandbox adicional de sistema de archivos a nivel de SO para los subprocesos.

Modo administrador no eleva los privilegios de LocalBridge en su conjunto. La ruta ordinaria sigue usando el token del usuario actual; solo la ruta explícita elevated_exec → Privileged Broker → Windows UAC puede obtener un token de administrador. El plano de control propio de LocalBridge nunca puede modificarse a través de MCP.

Modelo de seguridad

• La Runtime API Key se guarda únicamente en Windows Credential Manager y no se escribe en la configuración ordinaria, la línea de comandos ni los registros.

• La escucha local se mantiene únicamente en loopback.

• Las capacidades desconocidas y los comportamientos privilegiados no auditados fallan en modo cerrado.

• Las capacidades de administrador deben pasar por la confirmación de riesgo dentro de la aplicación y por el UAC de Windows; un inicio en segundo plano no mostrará UAC automáticamente.

• El runtime y las herramientas de terceros tienen versiones fijas y sumas de verificación; el runtime de la aplicación no descarga actualizaciones automáticamente.

• Sin telemetría, sin subida automática de volcados de memoria.

Consulte SECURITY.md para conocer el perímetro de seguridad completo y cómo informar de vulnerabilidades.

Instalación

Tras la publicación de la primera versión estable, se recomienda obtener el instalador de Windows 11 x64 desde GitHub Releases y verificar la información del lanzamiento. Antes del lanzamiento estable, se puede compilar desde el código fuente siguiendo los pasos que se indican a continuación.

LocalBridge utiliza el WebView2 del sistema y no incluye WebView2 Runtime; no depende del Python del sistema; el paquete de distribución incluye un Python Embedded Runtime fijo.

Compilación de desarrollo

Requisitos:

• Windows 11 x64

• Node.js 24

• Rust 1.85 o una cadena de herramientas estable compatible más reciente (MSVC)

• curl.exe del sistema Windows y el entorno de compilación habitual de Windows SDK/MSVC

npm ci
node scripts/prepare-lb018-resources.mjs
npm test
npm run build
cargo test --manifest-path src-tauri/Cargo.toml --locked -- --test-threads=1
cargo clippy --manifest-path src-tauri/Cargo.toml --locked --all-targets -- -D warnings
node node_modules/@tauri-apps/cli/tauri.js build --bundles nsis

aria2c, 7z y jq se obtienen únicamente en la fase de preparación de la compilación desde fuentes fijas y mediante SHA-256; el runtime no los descarga ni los actualiza automáticamente.

Limitaciones conocidas

• Actualmente solo es compatible con Windows 11 x64.

• v0.1 no ofrece WSL/container/remote shell, registro de shells personalizado ni historial genérico de tareas/reversión de instantáneas.

• Los subprocesos del modo completo disponen de los recursos del SO a los que el propio usuario de Windows actual puede acceder; la restricción del área de trabajo activa solo limita las entradas estructuradas propias de LocalBridge y no constituye una sandbox adicional del SO.

• La conexión Tunnel/ChatGPT requiere una configuración válida propia del usuario.

• La aplicación no incluye un actualizador automático; las actualizaciones se distribuyen como lanzamientos de versiones completas de LocalBridge.

Licencia

El código fuente propio de LocalBridge se distribuye bajo la MIT License. Los runtimes y las dependencias de terceros mantienen sus respectivas licencias; consulte THIRD_PARTY_NOTICES.md para más detalles.