LocalBridge

LocalBridge는 Windows 11 x64용 로컬 MCP 브리지 애플리케이션으로, ChatGPT 등 MCP 클라이언트가 사용자가 명시적으로 승인한 경계 내에서 로컬 개발 작업 공간에 접근하고 개발 작업을 수행하며, 필요 시 독립적인 UAC/Broker 경로를 통해 관리자 작업을 실행할 수 있게 합니다.

도구 구조

LocalBridge의 공용 Agent API는 8개의 일반 핵심 도구 + 1개의 권한 확장을 유지합니다:

• workspace_context: 작업 공간, 프로젝트, 실행 환경 및 권한 상태 탐색.

• agent_workflow: 진단, 수리, 기능, 리팩터링, 테스트, 빌드, 문서 및 복구 오케스트레이션.

• exec_command: 권한 모드에 따라 제한되는 일반 명령/프로세스 실행.

• command_control: 실행 중인 명령의 poll / read / write / kill.

• task_control: 현재 상위 작업의 get / cancel.

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

• document_workflow: 제어된 문서 읽기 및 생성.

• view_image: 제어된 이미지 읽기 및 크기 조정.

• elevated_exec: 권한 확장; 관리자 모드이고 Broker가 사용자 UAC 승인을 받은 경우에만 관리자 라우팅을 실행할 수 있습니다.

Related MCP server: bridge-mcp

권한 모드

편집 모드는 현재 활성 작업 공간 내의 구조화된 파일, Git, 편집 등의 작업만 허용하며, 일반 Shell/프로세스 실행은 허용하지 않습니다.

전체 모드는 cmd, PowerShell 및 개발 프로세스를 허용하지만, 프로세스는 항상 현재 Windows 일반 사용자 Token을 사용합니다. LocalBridge의 구조화된 경로, workdir, Git, 문서, 이미지 및 편집 입력은 여전히 활성 작업 공간으로 제한됩니다. LocalBridge는 하위 프로세스에 대한 추가 OS 수준 파일 시스템 샌드박스를 제공한다고 주장하지 않습니다.

관리자 모드는 LocalBridge 전체를 권한 상승시키지 않습니다. 일반 경로는 여전히 현재 사용자 Token을 사용합니다. 명시적인 elevated_exec → Privileged Broker → Windows UAC 경로만 관리자 Token을 획득할 수 있습니다. LocalBridge 자체 제어면은 MCP를 통한 수정이 항상 허용되지 않습니다.

보안 모델

• Runtime API Key는 Windows Credential Manager에만 저장되며, 일반 구성, 명령줄 또는 로그에 기록되지 않습니다.

• 로컬 수신은 loopback-only로 유지됩니다.

• 알 수 없는 기능과 검토되지 않은 권한 동작은 fail closed입니다.

• 관리자 기능은 앱 내 위험 확인과 Windows UAC를 반드시 거쳐야 합니다. 백그라운드 시작은 UAC를 자동으로 표시하지 않습니다.

• 런타임 및 타사 도구는 고정 버전과 검증 값을 사용합니다. 앱은 실행 중에 자체 업데이트를 자동으로 다운로드하지 않습니다.

• 원격 측정 없음, 충돌 자동 업로드 없음.

더 완전한 보안 경계와 취약점 보고 방법은 SECURITY.md를 참조하세요.

설치

첫 번째 안정 버전 출시 후에는 GitHub Releases에서 Windows 11 x64 설치 패키지를 받아 출시 정보를 검증하는 것을 권장합니다. 안정 버전 출시 전에는 아래 단계에 따라 소스에서 빌드할 수 있습니다.

LocalBridge는 시스템 WebView2를 사용하며 WebView2 Runtime을 번들하지 않습니다. 시스템 Python에 의존하지 않으며, 릴리스 패키지에는 고정된 Python Embedded Runtime이 포함됩니다.

개발 빌드

요구 사항:

• Windows 11 x64

• Node.js 24

• Rust 1.85 또는 그 이상의 호환 가능한 안정 툴체인(MSVC)

• Windows 시스템 curl.exe 및 일반 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 및 jq는 빌드 준비 단계에서만 고정 소스와 SHA-256으로 획득됩니다. 런타임은 이를 자동으로 다운로드하거나 업데이트하지 않습니다.

알려진 제한 사항

• 현재 Windows 11 x64만 지원합니다.

• v0.1은 WSL/container/remote shell, 사용자 지정 shell registry 또는 일반 작업 기록/스냅샷 롤백을 제공하지 않습니다.

• 전체 모드의 하위 프로세스는 현재 Windows 사용자가 접근할 수 있는 OS 리소스를 보유합니다. 활성 작업 공간 제한은 LocalBridge 자체의 구조화된 입력만 제한하며, 추가 OS 샌드박스를 구성하지 않습니다.

• Tunnel/ChatGPT 연결에는 사용자 자신의 유효한 구성이 필요합니다.

• 앱에는 자동 업데이터가 포함되지 않습니다. 업그레이드는 전체 LocalBridge 버전 릴리스 단위로 제공됩니다.

라이선스

LocalBridge 자체 소스 코드는 MIT License를 사용합니다. 타사 런타임 및 종속성은 각각의 라이선스를 유지하며, 자세한 내용은 THIRD_PARTY_NOTICES.md를 참조하세요.