Autodesk Native Agent Runtime for Revit 2024

AI 에이전트(Antigravity, Claude 등)와 Autodesk Revit 2024를 연결하는 프로덕션급 브리지로, Model Context Protocol(MCP) 기반으로 구축되었습니다.

아키텍처

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

빠른 시작

1. 사전 요구사항

• Revit 2024 설치 (애드인 빌드에 필외)

• . NET SDK (C# 프로젝트 빌드용)

• Node.js 18+ (MCP TypeScript 서버용)

• PowerShell (빌드/설치 스크립트용)

2. REVIT_2024_PATH 설정

Revit이 기분 위치(C:\Program Files\Autodesk\Revit 2024)에 없는 경우 환경 변수를 설정하세요:

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

3. 빌드

.\scripts\build-all.ps1

4. 애드인 설치

.\scripts\install-revit2024.ps1

5. Revit 2024 열기

Revit 프로젝트를 열거나 생성하세요. 애드인이 명명된 파이프 서버를 자동으로 시자합니다.

6. MCP 서버 시작

.\scripts\start-mcp.ps1

7. Antigravity 구성

MCP 서버를 Antigravity 구성에 추가하세요:

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

8. 상태 확인

에이전트에서 revit_get_status를 호출하세요. 다음과 같은 결과가 표시됩니다:

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

9. 플랜 미리보기

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. 승인 및 커밋

같은 플랜으로 revit_commit_plan을 호출하세요. 확인이 필외한 경우 Revit에서 승인하세요.

11. 감사 로그 확인

감사 로그는 %LOCALAPPDATA%\AutodeskNativeAgent\logs에 JSONL 파일로 저장됩니다.

지원되는 작업

MCP 도구

핵심 설게 결정

1. 백그라운드 스레드에서 Revit API 호출 금지 — 모든 Revit API 호출은 ExternalEvent 디스패처를 거칩니다.

2. 원자적 실핼 — 플랜은 단일 TransactionGroup 내에서 실핼되며, 실패 시 롤백됩니다.

3. 구조화된 오류 — 모든 실패에는 안정적인 오류 코드가 포함됩니다.

4. 단위 안전성 — 모든 길이는 명시적 단위를 가지며, 하드코딩된 / 304.8이 없습니다.

5. 타입 안전성 — 타입/레벨 해석은 결정적이며, 임의의 FirstElement()를 사용하지 않습니다.

6. 경로 보안 — Export/SaveAs 경로는 정규화되며 경로 탐색(traversal) 여부가 검사됩니다.

7. 확인 토큰 — 파적인 작업에는 사람의 승인이 필외합니다.

문서

• 아키텍처

• [보안](docs/SE CURITY.md)

• 명령어

• 문제 해결

• Re vit 2024 개발

• [AutoCAD로 확장](docs/EXTENDING-TO-AUTO CAD.md)

• 수동 테스트 체크리스트

라이선스

MIT