ATLAS-GATE MCP (Edición VS Code)

La pasarela de seguridad intermediada para IA agente en un único IDE

ATLAS-GATE es una pasarela de seguridad de confianza cero que impone que "los planes son leyes" para los agentes de IA. Esta versión está optimizada para VS Code, consolidando el antiguo modelo de agente dual (Antigravity/Windsurf) en un único intermediario MCP de alto rendimiento.

🔐 El problema: El caos de los agentes

Los agentes de IA pueden escribir código arbitrario en cualquier archivo, sin autorización previa, sin rastro de auditoría y sin control de calidad. ATLAS-GATE soluciona esto exigiendo que cada escritura de archivo pase por una tubería criptográfica de cinco puertas antes de que un solo byte llegue al disco.

🏗️ La solución: Arquitectura intermediada

En lugar de gestionar dos agentes y servidores separados, ATLAS-GATE ahora funciona como un único servidor MCP que gestiona internamente el ciclo de vida de sus cambios.

• Un servidor: atlas-gate maneja tanto la planificación como la ejecución.

• Una sesión: El intermediario mantiene el estado, los planes activos y los registros de auditoría.

• Una configuración: Configuración sencilla en .vscode/mcp.json.

Cómo funciona (La tubería de cinco puertas)

Cada llamada a write_file pasa por cinco puertas secuenciales:

1. Esquema: Valida la estructura de entrada.

2. Autoridad del plan: Asegura que exista un plan activo y firmado en la sesión del intermediario.

3. Intención: Requiere un archivo complementario .intent.md que explique por qué se está realizando el cambio.

4. Detección de stubs: Bloqueos a nivel de AST en TODO, mock, catch vacíos, etc.

5. Confirmación de auditoría: Escribe en el disco y añade al registro de auditoría encadenado por hash.

🚀 Inicio rápido (VS Code)

1. Instalación

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

2. Configuración automatizada

Ejecute el script de configuración para generar su configuración MCP de VS Code:

npm run setup:vscode

Esto crea un archivo .vscode/mcp.json que apunta al intermediario local.

3. Verificar el entorno

Ejecute el script de diagnóstico para asegurarse de que todo esté listo:

npm run doctor:vscode

🔌 Configuración del cliente MCP

VS Code (con soporte para Copilot/MCP) ahora verá un único servidor:

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

⚡ El flujo de trabajo intermediado

1. Inicializar: Llame a begin_session con la raíz de su espacio de trabajo.

2. Planificar: Redacte su plan y llame a lint_plan.

3. Autorizar: Llame a save_plan. El intermediario firma el plan y lo bloquea en la sesión actual.

4. Ejecutar: Llame a write_file. El intermediario valida automáticamente el plan bloqueado en la sesión.

5. Verificar: Llame a verify_phase para confirmar la integridad de sus cambios.

⚙️ Scripts clave

🛡️ Invariantes de gobernanza

ATLAS-GATE impone ocho invariantes mecánicos (I1–I8) para garantizar la auditabilidad total y la calidad del código. Desde el confinamiento de rutas (I3) hasta la aplicación de cero stubs (I4), el intermediario asegura que sus agentes de IA permanezcan dentro de los límites que usted defina.

🤝 Contribución

El nivel de calidad se aplica mecánicamente. Las solicitudes de extracción (PR) que contengan TODO, implementaciones de stub o manejadores de errores vacíos serán rechazadas por la misma tubería que gobierna a los agentes de IA.

Autor: Dylan Marriner · Versión: 2.1.0 · Licencia: MIT