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、編集などの操作のみが許可され、通常のシェル/プロセスの起動は許可されません。

完全モードでは、cmd、PowerShell、開発プロセスが許可されますが、プロセスは常に現在の Windows 通常ユーザートークンを使用します。LocalBridge の構造化パス、workdir、Git、ドキュメント、画像、編集入力は引き続きアクティブなワークスペースに制限されます。LocalBridge は、子プロセスに対して追加の OS レベルのファイルシステムサンドボックスを提供するものではありません。

管理者モードは LocalBridge 全体を昇格させません。通常ルートは現在のユーザートークンを使用します。明示的な elevated_exec → Privileged Broker → Windows UAC ルートのみが管理者トークンを取得できます。LocalBridge 自身の制御面は、MCP を介した変更は常に許可されません。

セキュリティモデル

• Runtime API Key は Windows Credential Manager にのみ保存され、通常の設定、コマンドライン、ログには書き込まれません。

• ローカルリスニングは loopback のみに制限されます。

• 未知の機能と未審査の特権動作は 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/コンテナ/リモートシェル、カスタムシェルレジストリ、汎用タスク履歴/スナップショットロールバックは提供されません。

• 完全モードの子プロセスは、現在の Windows ユーザーがアクセスできる OS リソースを持ちます。アクティブなワークスペース制限は LocalBridge 自身の構造化入力を制約するだけで、追加の OS サンドボックスを構成するものではありません。

• Tunnel/ChatGPT 接続には、ユーザー自身の有効な設定が必要です。

• アプリには自動更新機能は含まれません。アップグレードは完全な LocalBridge バージョンリリース単位で行われます。

ライセンス

LocalBridge 独自のソースコードは MIT License を使用します。サードパーティのランタイムと依存関係はそれぞれのライセンスを保持し、詳細は THIRD_PARTY_NOTICES.md を参照してください。