agent-env-mcp

Контроллер MCP на стороне хоста, который владеет переиспользуемой средой выполнения разработки Linux и предоставляет кодинг-агентам узкую границу рабочей области/инструментов, ограниченную проектом.

Граница доверия

• Процесс MCP запускается на хосте, потому что он должен управлять Docker.

• Модели никогда не предоставляется инструмент файловой системы хоста или произвольный инструмент команд хоста.

• VS Code передает текущую открытую рабочую область один раз при запуске MCP через AGENT_HOST_WORKSPACE.

• Эта рабочая область bind-монтируется в среду выполнения, принадлежащую агенту, по пути /agent-env/environment/<project-slug>.

• Чтение файлов, поиск, правки, локальный Git, сборка, тесты и другое выполнение команд происходят внутри Linux-контейнера agent.

• Среда выполнения не имеет Docker-сокета и не монтирует учетные данные GitHub.

• Compose и Dockerfile принадлежат этому репозиторию, а не репозиторию приложения.

Предоставляемые инструменты

• ensure_environment

• list_directory

• read_file

• search_workspace

• workspace_edit

• run_command

• git_command

run_command использует структурированное выполнение program + args без оболочки и отказывается от прямого Git. git_command предназначен для GitHub Operator, отключает хуки/подпись репозитория и разрешает только локальный список разрешенных подкоманд Git; сетевые операции Git намеренно исключены.

Установка

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

Добавьте сервер в пользовательскую конфигурацию MCP VS Code, используя mcp.json.example.

Важная настройка:

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

Модель не может выбрать другую рабочую область хоста после запуска MCP-сервера.

Проверка

После перезапуска MCP-сервера:

1. ensure_environment

2. list_directory с path: "."

3. read_file на известном файле проекта

4. search_workspace для известного символа/текста

5. run_command с program: "pwd"

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

Ожидаемые ошибки границы:

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

• абсолютный путь

• путь Windows

• прямое чтение .git

• run_command с bash

• run_command с docker

• run_command с git

Миграция

После подтверждения новой среды выполнения:

1. Удалите принадлежащий проекту .devcontainer.

2. Удалите общие execute, read, edit и search VS Code из Software Engineer.

3. Для строгой границы чтения только в контейнере также удалите семантические инструменты C/C++ VS Code, которые проверяют исходный код за пределами agent-env.

4. Дайте GitHub Operator agent-env/git_command для локального Git.

5. Оставьте удаленные операции GitHub в GitHub MCP.

Базовая среда выполнения

Включенный Dockerfile использует Node 24 LTS, инструменты сборки C/C++, Python, PlatformIO 6.1.19, Git и ripgrep. Профили среды выполнения можно разделить позже без изменения модели доверия.