revit-ai-native
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 ResponseRelated 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.ps14. 애드인 설치
.\scripts\install-revit2024.ps15. Revit 2024 열기
Revit 프로젝트를 열거나 생성하세요. 애드인이 명명된 파이프 서버를 자동으로 시자합니다.
6. MCP 서버 시작
.\scripts\start-mcp.ps17. 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 도구
도구 | 설멍 |
| 연결 상태 및 문서 정보 |
| 프로토콜 버전, 메서드, 작업 |
| 활성 문서 식별 정보 |
| 현재 선택 항목 |
| 구좋화된 요소 리 |
| 실핼하지 않고 검증 |
| 드라런 실핼 |
| 트랜잭션 내에서 실핼 |
| 작업 상태 및 결과 |
| 대기 중/실핼 중인 작업 취소 |
| 완료된 작업 롤백 |
| 민감 정보가 제거된 감사 항목 |
핵심 설게 결정
백그라운드 스레드에서 Revit API 호출 금지 — 모든 Revit API 호출은 ExternalEvent 디스패처를 거칩니다.
원자적 실핼 — 플랜은 단일 TransactionGroup 내에서 실핼되며, 실패 시 롤백됩니다.
구조화된 오류 — 모든 실패에는 안정적인 오류 코드가 포함됩니다.
단위 안전성 — 모든 길이는 명시적 단위를 가지며, 하드코딩된
/ 304.8이 없습니다.타입 안전성 — 타입/레벨 해석은 결정적이며, 임의의
FirstElement()를 사용하지 않습니다.경로 보안 — Export/SaveAs 경로는 정규화되며 경로 탐색(traversal) 여부가 검사됩니다.
확인 토큰 — 파적인 작업에는 사람의 승인이 필외합니다.
문서
[보안](docs/SE CURITY.md)
[AutoCAD로 확장](docs/EXTENDING-TO-AUTO CAD.md)
라이선스
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read and edit the Revit 2024–2027 model on your PC. Needs the free Revit MCP add-in.
AI for Revit: 450+ tools, 1 undo step. Windows, Revit 2024–2027 (2021–2023 included). Free account.
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Related MCP Servers
- AlicenseAqualityFmaintenanceAllows AI to interact with Autodesk Revit via the MCP protocol, enabling retrieval of project data and automation of tasks like creating, modifying, and deleting elements.13482MIT
- AlicenseBqualityNot gradedmaintenanceAllows AI assistants to interact with Autodesk Revit through the MCP protocol, enabling the AI to create, modify, and delete elements in Revit projects.1559 npm1-
- AlicenseAqualityFmaintenanceEnables AI to interact with Revit via MCP, allowing data retrieval and element creation, modification, and deletion.13MIT
- AlicenseBqualityCmaintenanceEnables AI agents to connect to Autodesk Revit and run Revit API Python, inspect models, capture screenshots, request user element selections or annotated snips, and manage multi-instance connections through MCP.13MIT