Secure Local Workspace MCP（セキュアなローカルワークスペース MCP）

English | 中国語（デフォルト）

ChatGPT と Codex のための安全なローカルワークスペースゲートウェイです。MCP を介して明示的に認可されたプロジェクトディレクトリのみを公開し、制限付きのファイル読み取り、検索、パッチ変更、Git チェック、ホワイトリスト方式のタスク機能を提供します。モデルに対して、任意の Shell、削除、コミット、プッシュ、デプロイ権限は公開しません。

利用シナリオ

• ChatGPT Web 版で、ローカルプロジェクトのコードを読み取り・分析・修正する。

• Codex が統合された MCP ツールを使って、ユーザーが明示的に認可した複数のプロジェクトへアクセスする。

• 書き込み操作に、ディレクトリ境界・ファイルサイズ・SHA-256 の同時実行保護を適用する。

• テストやビルドなどを、ローカル設定内のタスクホワイトリストに限定する。

機能とセキュリティ境界

サーバー側は実際のパスを検証し、..、絶対パス、シンボリックリンクによる越境を防ぎます。プロジェクトはデフォルトで読み取り専用です。writable: true に設定したプロジェクトのみ、書き込みツールが有効になります。

このプロジェクトが意図的に提供しない機能：

• 任意の Shell や任意のコマンド実行

• ファイルの削除、または上書きによる作成

• Git commit、push、ブランチの書き換え

• 本番デプロイやリモートサーバー操作

ディレクトリとプライバシーデータ

リポジトリには、ソースコード・設定例・自動化スクリプトのみを置いてください。実際の認可設定、API Key、トンネル設定、ログは必ずリポジトリの外に配置してください。

Windows 推奨ディレクトリ:

项目源码              <clone-directory>
授权配置              %USERPROFILE%\.secure-local-workspace-mcp\config.json
隧道 profile          %USERPROFILE%\.secure-local-workspace-mcp\tunnel-profiles\
运行时 API Key        用户自选的受保护文件或环境变量
tunnel-client         用户自选的本机工具目录

旧バージョンの %USERPROFILE%\.local-project-workspace\config.json も、新しいパスが存在しない場合に限り引き続き自動読み込みされるため、無停止でアップグレードできます。

動作環境

• Windows、macOS、Linux。および macOS と Linux に対応。自動化スクリプトは主に Windows PowerShell。

• Node.js 20 以降

• Git

• ChatGPT Web 版に接続する場合：OpenAI Platform で Tunnel を作成し、ChatGPT の開発者モードを利用できること。

完全な手動セットアップ手順

1. リポジトリを取得し、依存関係をインストールする

git clone https://github.com/dxawdc/secure-local-workspace-mcp.git
Set-Location .\secure-local-workspace-mcp
npm ci
npm test
npm run smoke:mcp

2. ローカライズ認可設定を作成する

自動化スクリプトで、最初のプロジェクト設定を作ることを推奨します：

.\scripts\bootstrap-config.ps1 `
  -ProjectId "my-app" `
  -ProjectLabel "我的应用" `
  -ProjectRoot "D:\Projects\my-app"

スクリプトはデフォルトで読み取り専用プロジェクトを作成します。書き込みリスクを確認した上で、明示的に -Writable を追加：

.\scripts\bootstrap-config.ps1 `
  -ProjectId "my-app" `
  -ProjectLabel "我的应用" `
  -ProjectRoot "D:\Projects\my-app" `
  -Writable `
  -Force

config.example.json をコピーして、次の名前で保存しても構いません：

%USERPROFILE%\.secure-local-workspace-mcp\config.json

タスクホワイトリストの例：

{
  "tasks": {
    "test": {
      "command": "npm",
      "args": ["test"],
      "timeoutSeconds": 300
    }
  }
}

ChatGPT / Codex はタスク名 型であるてタスク test` のみ投す能で、コマンドとパパメタの変更もできません。

3. ローカルでこちらで MCP を出動し、確認する

.\scripts\start-local.ps1

または：

npm start

プロセスは標準エへーに実際の設定パスと承認プロジェクト数を出しします。MCP 自もは stdio うとめ、フォワグラウンドー出力ー上に H ttp ページはあません。

4. Codex を 接続 す る

リポジトりには.codex-plugin/plugin.json、.mcport.json と付随スキルが含まれています。パーソナルプらグインの後方互換ID は local-project-workspace のままで、既存戦略のインストールが破とな;せしいようになっています。楽しい表示名は Secure Local Workspace MCP に更新されました。

リポジトリーーを %USERPROFILE%\plugins\local-project-workspace に置くか、クローン先ディレクトリへジャ'ンめーションを作成して、マ...ケットからたアプをインストールクション--ワートしてください。更新後、新しCode x タスク=をぜこために、M CP と思う を再読み込みす...。

5. OpenAイ Secure MCP Tunnel を作成する

1. OpenAI Platform で Tunnel を作成し、ターゲット ChatGPT ワークスペースた結び付けます。

2. 独立したンだとRuntime API Key を作成。長運ぶプながだげし、ではない。

3. OpenAI 純正 tunnnel-client をダウンロードし、リリースページ記載の SHA-256 を検証してから解凍します。

4. Runtime API Key はリポジトリ外の保護された置き場し、環境変数管理的に注し。コマンド履歴や、Git には、決入れてなりません。

5. スクリプトを使てプロフィル作成と確認をします。

ACL に保護されたファイル参照を使うことを推奨します。次のコマンドはは、ファイルないパスだけを渡す、鍵の内を読み取ったり表示したりません：

.\scripts\setup-tunnel.ps1 `
  -TunnelId "tunnel_REPLACE_ME" `
  -TunnelClient "C:\Tools\tunnel-client\tunnel-client.exe" `
  -ControlPlaneApiKeyRef "file:C:\Secrets\openai-tunnel-runtime-key.txt" `
  -ProfileDir "$env:USERPROFILE\.secure-local-workspace-mcp\tunnel-profiles"

ローカル proxy 経由 for OpenAI 接続する場合：

.\scripts\setup-tunnel.ps1 `
  -TunnelId "tunnel_REPLACE_ME" `
  -TunnelClient "C:\Tools\tunnel-client\tunnel-client.exe" `
  -ControlPlaneApiKeyRef "file:C:\Secrets\openai-tunnel-runtime-key.txt" `
  -ProfileDir "$env:USERPROFILE\.secure-local-workspace-mcp\tunnel-profiles" `
  -HttpProxy "http://127.0.0.1:7890"

スクリプトトは、truである tunnel-client init と doctor --explain を実行。チェック成功したら、フォアグラウンドで起動します。 起動させて:

& "C:\Tools\tunnel-client\tunnel-client.exe" run `
  --profile secure-local-workspace-mcp `
  --profile-dir "$env:USERPROFILE\.secure-local-workspace-mcp\tunnel-profiles"

6. ChatGPT の Web ー で プライベートアプリ 련し

1. нейтChatGPT設定開 き開発者どうモード有効に。

2. プラグイン画面 で「ア設り`"を選択。

3. 接続方法に「 Tunnelウンド」を選択し、作った Tunnel を選んでIDを入力。

4. このサービス自体 OAuth は不要なため、認証方式「認証なし」を選択。トンネル Runtime キーはローカルくライエンドとント内のコントローラー間のみで使用。

5. リスキを確認読み、確認うえで作成と接続。

6. 検索 discovered of ツールの 10 ットるをとうか確認した後、read-only 検証を実行。

検証用プロンプト：

@Secure Local Workspace MCP 调用 list_projects，只返回项目名称和是否可写。

修正用プロンプト：

@Secure Local Workspace MCP 读取 my-app 的 README.md，先说明修改计划，再用哈希保护补丁修改并展示 git_diff。

自動セットアップ

リポジトリには、次の Windows PowerShell スクリプトがきよいです：

1. bootstrap-config.ps1 作成：認可プロジェクトの設定を作成しますが、秘密マテを全く取り扱いません。

2. setup-tunnel.ps1：Tunnel プロファイルを生成し、doctor の診断を実行ます。

3. register-tunnel-startup.ps1：検証済プロフィーを現在のユーザーのログオン時自動起動タスクとして登録します。

アプリ全体の自動化の例、パラメ名の説明、ロールバック、CI/CD のコツは以下を御覧ください：自動セットディリファレンス

毎日のように行うこと

現在の診断を表示

ChatGPT または Codex で diagnostics、list_projects を呼び出し。モデルがプロジェクトの ID を当てないでください。

プロジェクトをアップデート

git pull --ff-only
npm ci
npm test
npm run smoke:mcp

もし MCP のツール定義を変更したなら、tunnel-client を再起動し ChatGPT プラグインの定義を読み直し。Codex では新規タスクで。

ログイン時の自動起動タスクを停止

Stop-ScheduledTask -TaskName "Secure Local Workspace MCP Tunnel"

ログイン時の自動起動タスクを停止削除

Unregister-ScheduledTask -TaskName "Secure Local Workspace MCP Tunnel" -Confirm:$false

この操作はタスクのみ削除します。 Tunnel、API Key、profile、プロジェクト設定は削除されません。

トラブルシューティング

Tunnel はローカルで正常、ChatGPT への呼び出はタイムアっト

• api.openai.com:443 に proxy が必要がない。

• ブラウザがシステムプロキシを使っても、Go製の tunnel が同じプラクシーを使うとは限りません。

• プロフィールに対して http_proxy を設定するか、起動スクリプトプロセスに HTTPS_PROXY を設定する。

• tunnel-client tunnel status --json を使って process_running / ready などの違いを確認。

ChatGPT でツールが見つからない

• tunnel-client が動作 in 実行されているか確認。

• doctor --explain を実行。

• Tunnel が ChatGPT 現在のワークスペースに結び付けられているか。

• プラグイン設定で「更新 نسخをクリック。

• ログの「存在パスと認可プロジェクト数」を確認。

プロジェクト一覧が空

• 新版か旧版のどちらの設定パスを読み取っているか確認。

• LOCAL_PROJECT_WORKSPACE_CONFIG を設定してConfigファイルを明示的に指定可能。

• JSON 形式、プロジェクト ID、根ディレクトリの存在を確認。

書き込みが拒否される場合

• プロジェクトに writable: true が設定されている必要があります。

• 変更Parse file前に read_file を再呼出しし、最新の SHA-256 を入手。

• ファイル変更後、は自分が変わると古いハッシュは無効。これが期待したパラレル保護。

配布前のプライバシーチェック

公開フォークやコミット、する場合、最低限これらを確認。

• API Key、GITHUB_TOKEN、秘密鍵、証明書

• Tunnel ID、組織 ID、ワークスペース ID

• 実際の config.json、ログ、ダウンロードファイル、ランタイム profile

• 個人のユーザー名、絶対パス、プライベート リポジトリの URL

• node_modules、ビルド物、一時ファイル

リポジディリの .gitignore はよくある機密パスを網羅していますが、コミット前スキャンと鍵失効の手順に代わりはありません。

ライセンス

MIT