agent-env-mcp

Un controlador MCP del lado del host que posee un entorno de ejecución de desarrollo Linux reutilizable y expone un límite de espacio de trabajo/herramientas estrecho y limitado al proyecto para agentes de codificación.

Límite de confianza

• El proceso MCP se ejecuta en el host porque debe controlar Docker.

• Al modelo nunca se le proporciona una herramienta de sistema de archivos del host ni una herramienta de comandos arbitrarios del host.

• VS Code pasa el espacio de trabajo actualmente abierto una vez al inicio del MCP a través de AGENT_HOST_WORKSPACE.

• Ese espacio de trabajo se monta mediante bind en un entorno de ejecución propiedad del agente en /agent-env/environment/<project-slug>.

• Las lecturas de archivos, búsquedas, ediciones, Git local, compilaciones, pruebas y otras ejecuciones de comandos ocurren dentro del contenedor Linux agent.

• El entorno de ejecución no tiene socket de Docker ni montaje de credenciales de GitHub.

• Compose y Dockerfile son propiedad de este repositorio, no del repositorio de la aplicación.

Herramientas expuestas

• ensure_environment

• list_directory

• read_file

• search_workspace

• workspace_edit

• run_command

• git_command

run_command utiliza ejecución estructurada de program + args sin shell y rechaza Git directo. git_command está destinado al Operador de GitHub, desactiva los hooks/firmas del repositorio y solo permite una lista blanca de subcomandos de Git local; las operaciones de Git en red están excluidas intencionalmente.

Instalación

cd D:\mcp\agent-env-mcp
npm install

Agregue el servidor a la configuración de MCP de usuario de VS Code usando mcp.json.example.

La configuración importante es:

"env": {
  "AGENT_HOST_WORKSPACE": "${workspaceFolder}"
}

El modelo no puede seleccionar un espacio de trabajo de host diferente después de que el servidor MCP se inicie.

Verificación

Después de reiniciar el servidor MCP:

1. ensure_environment

2. list_directory con path: "."

3. read_file en un archivo de proyecto conocido

4. search_workspace para un símbolo/texto conocido

5. run_command con program: "pwd"

6. git_command con args: ["status", "--short"]

Fallos de límite esperados:

• read_file("../../anything")

• una ruta absoluta

• una ruta de Windows

• lecturas directas de .git

• run_command con bash

• run_command con docker

• run_command con git

Migración

Después de que el nuevo entorno de ejecución esté probado:

1. Elimine el .devcontainer propiedad del proyecto.

2. Elimine execute, read, edit y search genéricos de VS Code del Ingeniero de Software.

3. Para un límite de lectura estricto solo de contenedor, también elimine las herramientas semánticas de C/C++ de VS Code que inspeccionan el código fuente fuera de agent-env.

4. Dé al Operador de GitHub agent-env/git_command para Git local.

5. Mantenga las operaciones remotas de GitHub en el MCP de GitHub.

Línea base del entorno de ejecución

El Dockerfile incluido utiliza Node 24 LTS, herramientas de compilación de C/C++, Python, PlatformIO 6.1.19, Git y ripgrep. Los perfiles de entorno de ejecución se pueden dividir más adelante sin cambiar el modelo de confianza.