@brycepelletier/agent-env-mcp

Wiederverwendbarer hostseitiger MCP-Controller für eine gehärtete Linux-Softwareentwicklungslaufzeit.

0.3.1 Trust-Trennung

Die Compose-Laufzeit verfügt über zwei Ausführungsdomänen auf demselben Arbeitsbaum:

• agent: wird von Software-Engineer-Tools verwendet. Das echte .git-Verzeichnis wird mit einem root-eigenen tmpfs-Mount maskiert.

• git: wird nur von git_command verwendet. Es sieht das echte .git-Verzeichnis und hat network_mode: none.

Remote-Git/GitHub-Operationen gehören nicht in dieses Paket; sie sind für die separate GitHub-MCP-Trust-Domäne vorgesehen.

Related MCP server: anvil

Tools

• ensure_environment

• list_directory

• read_file

• search_workspace

• workspace_edit

• run_command

• git_command

Der MCP erkennt den aktiven VS-Code-Arbeitsbereich lazy über MCP-Roots, wenn ein Tool zum ersten Mal verwendet wird. Es ist keine ${workspaceFolder}-Startzeitvariable erforderlich.

Lokale Entwicklung

npm run link

Benutzerweite VS-Code-MCP-Konfiguration während der Verknüpfung:

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

Um den globalen Entwicklungs-Link zu entfernen:

npm run unlink

0.3.1 Akzeptanzprüfungen

Bevor das alte .devcontainer eines Projekts entfernt wird:

1. ensure_environment wird erfolgreich ausgeführt und meldet /agent-env/environment/<project>.

2. run_command kann das Projekt erstellen.

3. run_command kann den echten Git-Branch/Verlauf nicht abrufen, selbst wenn es Git indirekt über Python/Node aufruft.

4. git_command ["status", "--short", "--branch"] wird erfolgreich ausgeführt.

5. Der Git-Dienst hat keinen Netzwerkzugriff.

Die aktuelle .git-Maskierungsimplementierung geht von einem Standard-Checkout aus, bei dem .git ein Verzeichnis ist. Git-Worktrees/Submodule, die eine .git-Datei verwenden, sollten zurückgewiesen oder durch eine zukünftige Mount-Strategie behandelt werden, bevor diese Laufzeit als gehärtet für diese Repository-Formen betrachtet wird.