@brycepelletier/agent-env-mcp

Controlador MCP reutilizable del lado del host para un runtime de ingeniería de software Linux endurecido.

División de confianza 0.3.1

El runtime de Compose tiene dos dominios de ejecución sobre el mismo árbol de trabajo:

• agent: utilizado por las herramientas de Software Engineer. El directorio .git real está enmascarado con un montaje tmpfs propiedad de root.

• git: utilizado solo por git_command. Ve el directorio .git real y tiene network_mode: none.

Las operaciones remotas de Git/GitHub no pertenecen a este paquete; están destinadas al dominio de confianza MCP de GitHub separado.

Related MCP server: anvil

Herramientas

• ensure_environment

• list_directory

• read_file

• search_workspace

• workspace_edit

• run_command

• git_command

El MCP descubre el espacio de trabajo activo de VS Code de forma diferida a través de MCP Roots cuando se usa una herramienta por primera vez. No se requiere ninguna variable de tiempo de lanzamiento ${workspaceFolder}.

Desarrollo local

npm run link

Configuración MCP de VS Code a nivel de usuario mientras está vinculado:

"agent-env": {
  "type": "stdio",
  "command": "agent-env-mcp"
}

Para eliminar el enlace de desarrollo global:

npm run unlink

Comprobaciones de aceptación 0.3.1

Antes de eliminar el antiguo .devcontainer de un proyecto:

1. ensure_environment se ejecuta correctamente e informa de /agent-env/environment/<project>.

2. run_command puede compilar el proyecto.

3. run_command no puede obtener la rama/historial real de Git incluso si invoca Git indirectamente a través de Python/Node.

4. git_command ["status", "--short", "--branch"] se ejecuta correctamente.

5. El servicio de Git no tiene acceso a la red.

La implementación actual de enmascaramiento de .git asume un checkout estándar donde .git es un directorio. Los worktrees/submódulos de Git que usan un archivo .git deben rechazarse o gestionarse mediante una futura estrategia de montaje antes de tratar este runtime como endurecido para esas formas de repositorio.