Autodesk Native Agent Runtime for Revit 2024

Un puente de nivel de producción entre agentes de IA (Antigravity, Claude, etc.) y Autodesk Revit 2024, costruido sobre el Model Context Protocol (MCP).

Arquitectura

Antigravity / AI Agent
    ↓ (MCP over stdio)
MCP Server (TypeScript, Node.js)
    ↓ (Named Pipe, JSON envelopes)
Revit 2024 Add-in (.NET Framework 4.8)
    ↓ (ExternalEvent)
Main-thread Dispatcher → PlanExecutor
    ↓ (TransactionGroup)
Revit API (Document, Wall, FamilyInstance, ...)
    ↓ (Verification + Assertions)
Structured Result → MCP Response

Related MCP server: Revit MCP Server

Inicio rápido

1. Requisitos previos

• Revit 2024 instalado (requerido para la compilación del complemento)

• .NDET SDK (para compilar proyectos de C#)

• Node.js 18+ (para el servidor TypeScript de MCP)

• PowerShell (para scripts de compilación/instalación)

2. Definir REVIT_2024_PATH

Si Revit no está en la ubicación predeterminada (C:\Program Files\Autodesk\Revit 2024), define la variabe de entorno:

$env:REVIT_2024_PATH = "D:\REVIT\2024\Revit 2024"

3. Compilar

.\scripts\build-all.ps1

4. Instalar el complemento

.\scripts\install-revit2024.ps1

5. Abrir Revit 2024

Abre o crea un proyecto de Revit. El complemento inicia automáticamente el servidor de canalización con nombre.

6. Iniciar el servidor MCP

.\scripts\start-mcp.ps1

7. Configurar Antigravity

Añade el servidor MCP a tu configiración de Antigravity:

{
  "mcpServers": {
    "revit": {
      "command": "node",
      "args": ["e:\\revit-A.I Native\\apps\\agent-mcp\\dist\\index.js"]
    }
  }
}

8. Obtener el estdo

Lama a revit_get_sttus desde tu agente. Deberías ver:

{
  "connected": true,
  "activeDocumentTitle": "YourProject.rvt",
  "busy": false
}

9. Previsulizar un plan

Envía un plan a revit_preview_plan:

{
  "schemaVersion": "1.0",
  "requestId": "test-001",
  "description": "Create a 5000mm wall",
  "document": { "strategy": "active_document" },
  "units": "mm",
  "coordinateSystem": "project",
  "executionMode": "preview",
  "operations": [...],
  "safety": { "requireUserConfirmation": true }
}

10. Aprobar y confimar

Lama a revit_commit_plan con el mismo plan. Si se requere confimación, aprueba en Revit.

11. Inspeccionar el registo de auditoría

Los registos de auditoría se encuentran en %LOCALAPPDATA%\AutodeskNativeAgent\logs como archivos JSONL.

Operaciones compatiles

Herramientas MCP

Decisiones clave de diseño

1. Sin API de Revit desde subprocesos en segundo plano — Todas las llamadas a la API de Revit pasan por el despachador de ExternalEvent

2. Ejecución atómica — Los planes se ejecutan dentro de un único TransactionGroup; los fallos se revierten

3. Errores estructurados — Cada fallo lleva un código de error estable

4. Seguridad de unidades — Todas las longitudes llevan unidades explícitas; no hay / 304.8 codificado

5. Seguridad de tipos — La resolución de tipo/nivel es determinista; no hay FirstElement() aleatorio

6. Seguridad de rutas — Las rutas de Export/SaveAs se canonizan y se verifica que no haya saltos de directorio

7. Tokens de confirmación — Las operaciones destructivas requieren aprobación humana

Documentación

• Arquitectura

• Seguridad

• Comandos

• Solución de problemas

• Desarrollo para Revit 2024

• Extensión a AutoCAD

• Lista de verificación de pruebas manuales

Licencia

MIT