ATLAS-GATE MCP (версия для VS Code)

Единый шлюз безопасности для агентского ИИ в IDE

ATLAS-GATE — это шлюз безопасности с нулевым доверием, который обеспечивает соблюдение принципа «Планы — это законы» для ИИ-агентов. Эта версия оптимизирована для VS Code и объединяет бывшую двух-агентную модель (Antigravity/Windsurf) в единый высокопроизводительный MCP-брокер.

🔐 Проблема: Агентский хаос

ИИ-агенты могут записывать произвольный код в любой файл — без предварительной авторизации, без журнала аудита и без контроля качества. ATLAS-GATE решает эту проблему, требуя, чтобы каждая запись в файл проходила через пятиуровневый криптографический конвейер, прежде чем хотя бы один байт попадет на диск.

🏗️ Решение: Брокерная архитектура

Вместо управления двумя отдельными агентами и серверами, ATLAS-GATE теперь работает как единый MCP-сервер, который внутренне управляет жизненным циклом ваших изменений.

• Один сервер: atlas-gate обрабатывает как планирование, так и выполнение.

• Один сеанс: Брокер поддерживает состояние, активные планы и журналы аудита.

• Одна конфигурация: Простая настройка .vscode/mcp.json.

Как это работает (Пятиуровневый конвейер)

Каждый вызов write_file проходит через пять последовательных шлюзов:

1. Схема: Проверяет структуру входных данных.

2. Авторитет плана: Гарантирует наличие активного подписанного плана в сеансе брокера.

3. Намерение: Требует наличия сопутствующего файла .intent.md, объясняющего, почему происходит изменение.

4. Обнаружение заглушек: Блокировка на уровне AST для TODO, mock, пустых catch и т. д.

5. Фиксация аудита: Запись на диск и добавление в хеш-цепочку журнала аудита.

🚀 Быстрый старт (VS Code)

1. Установка

git clone https://github.com/dylanmarriner/ATLAS-GATE-MCP.git
cd ATLAS-GATE-MCP
npm install

2. Автоматизированная настройка

Запустите скрипт настройки, чтобы создать конфигурацию MCP для VS Code:

npm run setup:vscode

Это создаст файл .vscode/mcp.json, указывающий на локальный брокер.

3. Проверка окружения

Запустите скрипт диагностики, чтобы убедиться, что все готово:

npm run doctor:vscode

🔌 Конфигурация клиента MCP

VS Code (с поддержкой Copilot/MCP) теперь будет видеть один сервер:

{
  "servers": {
    "atlas-gate": {
      "command": "node",
      "args": ["/path/to/bin/atlas-gate-vscode.js"],
      "env": {
        "ATLAS_WORKSPACE_ROOT": "${workspaceFolder}",
        "ATLAS_HOST_IDE": "vscode"
      }
    }
  }
}

⚡ Брокерный рабочий процесс

1. Инициализация: Вызовите begin_session с корнем вашего рабочего пространства.

2. Планирование: Составьте план и вызовите lint_plan.

3. Авторизация: Вызовите save_plan. Брокер подписывает план и фиксирует его в текущем сеансе.

4. Выполнение: Вызовите write_file. Брокер автоматически проверяет соответствие плану, зафиксированному в сеансе.

5. Проверка: Вызовите verify_phase, чтобы подтвердить целостность ваших изменений.

⚙️ Основные скрипты

🛡️ Инварианты управления

ATLAS-GATE обеспечивает соблюдение восьми механических инвариантов (I1–I8) для обеспечения полной проверяемости и качества кода. От ограничения путей (I3) до запрета заглушек (I4), брокер гарантирует, что ваши ИИ-агенты остаются в рамках заданных вами правил.

🤝 Участие в разработке

Планка качества обеспечивается механически. PR, содержащие TODO, заглушки или пустые обработчики ошибок, будут отклонены тем же конвейером, который управляет ИИ-агентами.

Автор: Dylan Marriner · Версия: 2.1.0 · Лицензия: MIT