agent-env-mcp

Ein hostseitiger MCP-Controller, der eine wiederverwendbare Linux-Entwicklungslaufzeit besitzt und Coding-Agenten eine schmale, projektspezifische Arbeitsbereichs-/Werkzeuggrenze bereitstellt.

Vertrauensgrenze

• Der MCP-Prozess läuft auf dem Host, da er Docker steuern muss.

• Dem Modell wird niemals ein Host-Dateisystemwerkzeug oder ein beliebiges Host-Befehlswerkzeug gegeben.

• VS Code übergibt den aktuell geöffneten Arbeitsbereich einmalig beim MCP-Start über AGENT_HOST_WORKSPACE.

• Dieser Arbeitsbereich wird in eine agenteneigene Laufzeit unter /agent-env/environment/<project-slug> bind-gemountet.

• Dateilesevorgänge, Suchen, Bearbeitungen, lokales Git, Builds, Tests und andere Befehlsausführungen finden im Linux-agent-Container statt.

• Die Laufzeit hat keinen Docker-Socket und kein GitHub-Anmeldedaten-Mount.

• Compose und Dockerfile gehören zu diesem Repository, nicht zum Anwendungs-Repository.

Bereitgestellte Werkzeuge

• ensure_environment

• list_directory

• read_file

• search_workspace

• workspace_edit

• run_command

• git_command

run_command verwendet strukturierte Ausführung mit program + args ohne Shell und verweigert direktes Git. git_command ist für den GitHub Operator vorgesehen, deaktiviert Repository-Hooks/Signierung und erlaubt nur eine lokale Whitelist für Git-Unterbefehle; Netzwerk-Git-Operationen sind absichtlich ausgeschlossen.

Install

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

Fügen Sie den Server zur VS-Code-Benutzer-MCP-Konfiguration hinzu, indem Sie mcp.json.example verwenden.

Die wichtige Einstellung ist:

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

Das Modell kann nach dem Start des MCP-Servers keinen anderen Host-Arbeitsbereich auswählen.

Verifizierung

Nach dem Neustart des MCP-Servers:

1. ensure_environment

2. list_directory mit path: "."

3. read_file auf einer bekannten Projektdatei

4. search_workspace nach einem bekannten Symbol/Text

5. run_command mit program: "pwd"

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

Erwartete Grenzfehler:

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

• ein absoluter Pfad

• ein Windows-Pfad

• direkte .git-Lesezugriffe

• run_command mit bash

• run_command mit docker

• run_command mit git

Migration

Nachdem die neue Laufzeit bewiesen ist:

1. Entfernen Sie den projekteigenen .devcontainer.

2. Entfernen Sie generische VS-Code-execute-, read-, edit- und search-Operationen vom Software Engineer.

3. Entfernen Sie für eine strikte Container-nur-Lesegrenze auch die semantischen VS-Code-C/C++-Werkzeuge, die Quellcode außerhalb von agent-env untersuchen.

4. Geben Sie dem GitHub Operator agent-env/git_command für lokales Git.

5. Behalten Sie Remote-GitHub-Operationen im GitHub-MCP.

Laufzeit-Basis

Das enthaltene Dockerfile verwendet Node 24 LTS, C/C++-Build-Werkzeuge, Python, PlatformIO 6.1.19, Git und ripgrep. Laufzeitprofile können später aufgeteilt werden, ohne das Vertrauensmodell zu ändern.