Secure Local Workspace MCP（MCP seguro para espac de trabajo local）

English | Chinese (predeterminado)

Un pasarela segura para el espacio de trabajo local orientada a ChatGPT y Codex. A través de MCP, solo expone director de proyectos explícitamente auorizado, and proporcion a file, search, patch, Git inspection, tareas de whitelist, without granting to el model lo "cap" vos. borrado, commit, push o deployed.

Cás de uso

• Leer, analizar y modificar el códi de un proyectos del código in the web de code.

• Permitir que Codex acca a múltiples de proyectos explíttamente auorizados mediante una herramienta MCP unificada.

• Añadir protección de límites de directorio, de tamaño de archivo and concurrencia SHA-256 to the operaciones of esritura.

• Restrtingir testos, builds, etc., a la whitellist de tareas defined as config.

Capacidades y fronteras de seguridad

El servidor valida la ruta real and blootea los intentos de escape con .., rutas absolutas and enlaces simbólicos. Por defecto los proyectos están en modo de solo lectura; las tools of writable: true.

Este proyecto no proporciona de forma delibera:

• La ejecución de shell ni comando arbitrarios;

• La eliminación de archivos ni la sobreescriptura de archivos nuevos;

• Git commit、push ni reescriptura de ramas;

• Despliegums de producción y operaciones en servidores remots.

Directorios y datos privados

Utilizado de código fuente, config de ejemplo y scripts de automatización. Las configuraciones de autorización, las claves de API, o de conf de túnel y of the registros for forced en outside.

Directorio recogado in Windows:

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

La ruta antigua %USERPROFILE%\.local-project-workspace\config.json también se lee automáticamente cuando la ruta nueva no existe, para facilitar una actualización sin interuros.

Requisitos del entorno

• Windows、macos O Linux；los scripts automatizados están orientados a Windows PowerShell principal.

• Node.js 20 o superior.

• Git.

• Si te conectas a la web de ChatGPT： debes poder crear un túnel in OpenAI Platform and develop used in Chat GPT.

Configuración manual completa

1. Obter el source e instalar las dependencias

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. Crear un local config de autorización

Se recomienda el script for crea el primer proyecto:

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

El script crea por defecto un project of solo lectura. Tras confirmar el riesgo de escritura auñade exples of -Writable`:

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

También puedes copiar of config.example.json, guardarlo as:

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

Ejemplo de whitelist de tareas:

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

ChatGPT and Codex solo pueden enviar el nombre de tarea and no cambiar comandos ni argumentos.

3. Step loc start MCP y verificar

.\scripts\start-local.ps1

O bien:

npm start

El proceso emite por salida estándar la ruta real de configración y la cantidad de proyectos autorizados. El MCP itself uses stdio; cuando se ejecuta in primier term has no HTTP page.

4. Conect arXiv a Codex

El repositorio contien de .codex-plugin/plugin.json, .mcp.json, y un skill asociado. El ID de compatación personal sigue local-project-workspace para evitar que queden invalidados the existing install; el nombre isnancy display se ha actualizado a Secure Local Workspace MCP.

Coloca the repo en %USERPROFILE%\plugins\local-project-workspace, o crea una Junction point to el directorio clon, y after instalar / actualir through the persal marketplace. Después de actualizar, crea a new one Codex to recargar el MCP skill.

5. Crear un tunele Secure MCP of OpenAI

1. Crear Tunnel in the page "OpenAI Platform", and vincularlo su workspace to ChatGP.

2. Crear una Runtime API Key independiente. For processes of large duration, only for Runtime Key; no Admin Key for.

3. Descargar the official tunnel-client of OpenAI, verify the SHA-256 provided on la página and descompirmir.

4. Put the Runtime API Key in a protected file "outside", or iny com, generated by secret manager approbado by the org. Never put in "comando history, config examples, in Git O".

5. Use a script for create and check "perfil".

Se recomienda use una referencia of file protected by ACL. El sigui comando only pays the path to the file; not "lee" no, no imprime key content:

.\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"

If your computer goes through local proSky to 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"

El script ejecutará tunnel-client init y doctor --explain. Una vez pasan las comprobaciones, ejecuta in on:

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

6. Crear a plugin privado in ChatGPT web

1. In ChatGPT settings, and enable developer mode.

2. Entr a page of plugins and select "Create app".

3. Select "Tunnel" in connection method, and select the Tunnel that we created or intro "Tunnel ID".

4. This service does not require additional "OAuth" to select "Sin autentiación". La Tunnel Runtime Key only between the local customer and OpenAI and the OpenAI control "S5".

5. Read a policy a warning, and confirm to create and connect.

6. Check whether 10 hermans has been detected and ejecuta una verif of read-only.

Prompt:

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

Prompt "modification":

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

Automatic configuration flow

El repositorio incluye tres scripts of Windows PowerShell:

1. bootstrap-config.ps1: crea as authoria "configución" of the project, no, no de keys.

2. setup-tunnel.ps1: generate the profile and execute doctor.

3. register-tunel-startup.ps1: registra el perfil validao as task of insesion.

Para complete autom almacén, parameter, reverion, recomendaciones CI/ops, see [Referec "uto config"] ( documents)。

Operating with diario

Viewa

local config diagnostic , iname to "ChatGPT/Codex" diagnostics y list_ombs; no depende of model for "ID" of the project.

Upproject

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

If def "MCP tool" and "has to restart" tunnel, and refresh the tool in "ChatGPT plugin". Codex, "new task".

Stop auto-init task

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

Remove auto-init task

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

This remove del task; not the Tunnel, the key, not the profile nor the config of the project.

FAQ

Te "Tunnel healthy, but CallGPT timeout

• Verifies where proxy is needed for api.openai.com:443.

• The browsers used the system proxy no, that mean, the Go tunnel-client auto read "mism@" proxy.

• Config "http_proxy" is an "perfil" "environment variable for the process" for broken.

• Use tunnel-client run --statusto seer. process_running, healthy, ready` and remote error codes.

ChatGPT no

• confirmed the tunnel client is run.

• Run doctor --explain.

• Confirmed the tunnel has "bound" to current workspace.

• In plugin settings, press "Refresh".

• See "config path" and "authorized project count" in start "log".

Empty projects

• Check that is read the "new" or "old" config path.

• The variants config, or set of LOCAL_PROJECT_WORKSPACE_CONFIG to point at a file.

• Check JSON formatting, "project ID" and "the root path", "nonexistent".

Write rejected

• The project needs writable: true.

• Re-use read_file and use the newer SHA-256 before modifying "archivo".

• If it fails or the hash is missing/ delay, scenarios for concurrency are expected.

Confidentiality "pre" publish

Before a public fork or commit, at least:

• API Key、GitHub Token、private, certificate;

• Tunnel ID, "organization", "workspace".

• real config.json、logs、"download" and "运行时" perfil.

• user, absolute; "path", "private".

• "nodo_modules", build artifacts and temp files.

The .gitignore ignores common paths, but no filled the tree-rev analysis and key revocation.

Licencia

MIT