AEC Model Bridge의 개요
AEC Model Bridge는 A. Sam Mohammad가 관리하며, Claude, Codex, Cursor 등 MCP 클라이언트가 Revit 2024부터 2027까지에서 열린 모델을 읽고 편집하게 해 줍니다. 구성은 두 부분입니다. stdio로 클라이언트와 통신하는 Python MCP 서버, 그리고 127.0.0.1에서 대기하며 Revit 메인 스레드에서 작업을 실행하는 네이티브 C# Revit 애드인입니다. 읽기 전용 도구는 바로 실행됩니다. 기본 설정에서 모델을 바꾸는 도구는 사람이 Revit 패널이나 명령줄에서 계획을 승인할 때까지 막혀 있습니다. 같은 서버는 Revit 없이 IFC 파일을 읽고, Rhino, Grasshopper, Speckle도 다룹니다.
저장소는 2026년 1월에 만들어졌고 스타는 약 109개, 포크는 27개입니다. v1.4.0은 2026년 10월 9일에 나왔고 마지막 푸시는 2026년 10월 28일입니다. 라이선스는 Revit Linking Exception이 붙은 GPL-3.0-or-later이며, 관리자에게 상용 라이선스를 받을 수도 있습니다. README는 아직 실제 Revit 세션에서 검증된 것이 없다고 분명히 밝힙니다.
AEC Model Bridge 설치 방법
uvx --from git+https://github.com/Sam-AEC/aec-model-bridge#subdirectory=packages/mcp-server-revit aec-model-bridgeAEC Model Bridge, 쓸 만한 가치가 있습니까?
AEC Model Bridge는 AI가 BIM 모델을 바꾸게 하는 문제를 저희가 읽어 본 어떤 Revit 서버보다 깊이 고민했습니다. 그러나 그중 어느 것도 작동한다고 아직 증명하지 못했습니다. README 스스로 실제 Revit 세션에서 검증된 것이 없다고 말합니다. Python 서버는 모의 프로바이더로 테스트하며, CI는 Revit을 한 번도 실행하지 않은 채 Revit 2024부터 2027까지용 애드인을 컴파일합니다. 그래서 이 프로젝트는 실제 고객 작업에 연결할 대상이 아니라 모델 사본으로 시범 운영할 대상입니다.
구조는 평범하고 견실합니다. Python 허브가 클라이언트와 stdio로 통신하며 각 호출을 프로바이더로 보냅니다. Revit 프로바이더는 동적 루프백 포트에서 네이티브 C# 애드인과 통신하며, 세션마다 무작위 bearer 토큰을 만듭니다. pyRevit은 쓰지 않습니다. pyRevit 브리지 모듈은 있지만, 스크립트를 실행할 애드인 쪽은 구현되지 않았습니다. 기본 설정은 도구 219개를 등록하며 그중 103개가 Revit용입니다. 생성된 카탈로그는 그중 42개를 읽기, 61개를 쓰기로 분류합니다. 쓰기 쪽에는 공개 Revit API 전체에 닿는 revit_execute_python과 revit_invoke_method가 있지만, 둘 다 변경 도구로 표시되어 승인 관문 뒤에 있습니다.
이 프로젝트를 볼 이유는 바로 이 관문입니다. 기본 ask_first 모드에서 어시스턴트는 plan_actions로 계획 초안을 씁니다. approve_plan, reject_plan, rollback_plan은 AI에 제공되지 않으며, 사람이 Revit 패널이나 aec-model-bridge-approve 명령으로 승인합니다. 승인은 계획의 콘텐츠 해시에 묶이며, 승인된 각 작업은 한 번만 실행됩니다. 보안 문서는 빈틈을 보기 드물게 솔직하게 나열합니다. 패널은 어시스턴트의 검토 메모를 보여 주지 않으므로, 명령줄의 show 보기만이 유일한 완전한 확인 수단입니다. 변경 전 값은 revit_set_parameter_value에 대해서만 기록됩니다. 승인은 만료되지 않 고 문서에 묶이지도 않으므로, 한 Revit 창에서 작성한 계획이 다른 창에서 실행될 수 있습니다. 같은 Windows 사용자로 실행되는 어떤 프로세스든 패널 토큰을 읽고 승인할 수 있으므로, 그 계정에서 셸을 가진 AI 클라이언트는 전체 체계를 무력화합니다.
실행 취소는 작업 단위입니다. 각 파라미터 또는 모델 편집은 이름 붙은 별도 트랜잭션에서 실행되므로, Ctrl+Z 한 번에 작업 하나가 취소됩니다. 저장, 중앙 모델 동기화, 스크립트는 해당되지 않습니다. 도구가 반환하는 모델 데이터는 클라이언트 뒤에 있는 AI 제공업체로 전송되며, 모델이 고객의 기밀 설계라면 중요한 문제입니다. 프로젝트 자체는 텔레메트리를 보내지 않으며, 요소 이름과 파라미터 값이 담긴 계획 파일과 증빙 파일은 로컬 작업 폴더에 남습니다.
회사가 이 위에 무언가를 만들기 전에 라이선스를 읽어야 합니다. GPL-3.0-or-later에 따라 사무소는 내부에서 무료로 사용하고 수정할 수 있습니다. 그러나 Revit Linking Exception은 이 코드를 독점 애드인에 넣는 것을 허용하지 않으며, 그러려면 상용 라이선스가 필요합니다. 이 분야는 붐비고 아직 젊습니다. mcp-servers-for-revit/revit-mcp는 스타가 약 475개지만 2026년 2월 이후 푸시가 없습니다. Autodesk의 Revit Public MCP Server는 Revit 2027.2 전용 기술 프리뷰이며, 도움말 페이지는 제안된 변경을 검토하고 모델을 백업하라고 안내합니다. AEC Model Bridge는 Revit 4개 연도 버전을 지원하며, 누가 변경을 승인하는가에 대해 가장 충실한 문서상의 답을 갖고 있습니다. 부족한 것은 그 답이 Revit 안에서도 유지된다는 증거입니다.
제 역할을 하는 곳
60명 규모 건축 사무소의 BIM 코디네이터
주간 조정 회의 전에 모델 경고 분류하기
서버를 look_only 모드로 실행하고, 어시스턴트에게 revit_get_warnings 출력을 설명별로 묶고 영향받는 요소 ID를 나열하라고 요청합니다. 이 모드에서는 아무것도 모델을 바꿀 수 없으므로, 위험은 경고 내용이 AI 제공업체에 노출되는 정도로 한정됩니다.
병원 프로젝트의 파라미터를 정리하는 BIM 매니저
벽 수백 개에 빠진 Comments 또는 Mark 값 채우기
에이전트가 plan_actions로 일괄 작업 초안을 쓰게 하고, aec-model-bridge-approve show로 읽은 뒤 승인하고 값을 다시 읽어 확인합니다. 계획은 작업 수백 개 이내로 유지하고, 계획 하나를 되돌리려면 Ctrl+Z를 여러 번 눌러야 한다는 점을 감안하십시오.
컨설턴트 모델을 받는 시공사의 설계 관리자
Revit을 열지 않고 IFC 파일의 층과 속성 확인하기
어떤 컴퓨터에서든 IfcOpenShell로 IFC를 읽는 ifc_get_spatial_structure, ifc_get_properties, ifc_validate를 씁니다. 이 부분에는 Revit 라이선스가 필요 없으며, 도구는 파일을 편집하지 않습니다.
자체 Revit 도구를 가진 엔지니어링 회사의 소프트웨어 책임자
브리지를 회사 자체 애드인에 통합할지 결정하기
먼저 모의 모드나 Docker 이미지에서 도구 목록을 평가합니다. 독점 애드인 안에 넣어 배포하려면 상용 라이선스가 필요하며, 조건과 가격은 관리자와 협의하고 공개되어 있지 않습니다.
도입 전 확인할 점
- 설정
- Windows 10 또는 11, 라이선스가 있는 Revit 2024부터 2027까지, Python 3.11 이상, uv가 필요합니다. v1.4.0 Windows 설치 프로그램은 Revit 연도 버전을 고르게 하고, 관리자 권한이 필요 없으며, 설정을 백업한 뒤 Claude Desktop과 VS Code를 구성할 수 있습니다. 그렇지 않으면 클라이언트에 uvx 줄을 추가하고 애드인용 install.ps1을 실행합니다. AEC Bridge 리본 탭과 /health 확인으로 연결을 점검합니다.
- 연동
- 기본 설정의 도구는 219개입니다. Revit용 103개에 더해 IFC, Rhino와 Grasshopper, Speckle, 스냅샷 QA/QC 모듈, 개발 중인 Navisworks 프로바이더가 있습니다. 도구에는 readOnlyHint와 destructiveHint 주석이 붙어 있습니다. 설정 문서는 Claude Desktop, GitHub Copilot을 쓰는 VS Code, Cursor, Codex용으로 있으며, 다른 stdio 클라이언트는 테스트되지 않았습니다.
- 데이터와 개인정 보
- 서버와 애드인은 로컬에서 실행되며 브리지는 루프백에서만 대기합니다. 도구가 모델에서 읽은 내용은 AI 제공업체로 전송되며, 패널의 내장 채팅은 Anthropic으로 보냅니다. 텔레메트리는 없습니다. 계획과 증빙 묶음은 요소 이름과 파라미터 값을 작업 폴더에 저장하며, 파일 접근은 MCP_REVIT_ALLOWED_DIRECTORIES로 제한됩니다.
- 대규모 사용 시 비용
- 소프트웨어는 GPL로 무료입니다. 실제 비용은 실제 환경에서 실행하는 사람마다 필요한 Revit 구독, AI 클라이언트 요금제나 토큰, 그리고 매 세션 도구 219개 목록이 차지하는 컨텍스트입니다. 상용 라이선스 가격은 공개되어 있지 않습니다.
- 제한
- 실제 Revit에서의 동작은 전반적으로 검증되지 않았습니다. README는 최신 릴리스보다 앞서 있을 수 있는 dev 브랜치를 설명합니다. 계획 실행은 크기가 커질수록 느려지므로 작업 수백 개 이내로 유지해야 합니다. rollback_plan에는 패널 버튼도 명령도 없으며, 공식 MCP Registry 항목은 여전히 v1.0.1로 표시합니다.
좋은 점
- 사람이 해시된 계획을 승인할 때까지 쓰기 도구가 막혀 있습니다
- 승인 도구는 AI에 절대 노출되지 않습니다
- Revit 2024부터 2027까지 지원하며, Revit 없이 IFC도 다룹니다
- 보안상 한계를 보기 드물게 자세히 문서화했습니다
아쉬운 점
- 스스로 밝히듯 실제 Revit 세션에서 검증된 적이 없습니다
- 패널 승인 화면은 어시스턴트의 검토 메모를 보여 주지 않습니다
- 승인은 만료되지 않고 문서에 묶이지도 않습니다
- GPL 때문에 유료 라이선스 없이는 독점 애드인에 넣을 수 없습니다
추천 대상
모든 변경에 사람의 승인이 필수인 환경에서, Revit 모델 사본으로 에이전트를 시범 운영할 의향이 있는 BIM 코디네이터와 디지털 실무 책임자.
AEC Model Bridge: 자주 묻는 질문
- AEC Model Bridge, 쓸 만한 가치가 있습니까?
- Revit 안에 에이전트를 두기 위한, 보기 드물게 신중한 승인 설계입니다. 관리자는 이 모든 것이 아직 실제 Revit 세션에서 실행된 적이 없다고 솔직하게 말합니다. 평점은 5점 만점에 3.4점입니다.
- AEC Model Bridge의 가격은 얼마입니까?
- Revit Linking Exception이 붙은 GPL-3.0-or-later로 무료이며, 요청하면 상용 라이선스를 받을 수 있습니다(가격 비공개). 라이선스가 있는 Revit 2024부터 2027까지가 필요합니다.
- AEC Model Bridge의 단점은 무엇입니까?
- 스스로 밝히듯 실제 Revit 세션에서 검증된 적이 없습니다; 패널 승인 화면은 어시스턴트의 검토 메모를 보여 주지 않습니다; 승인은 만료되지 않고 문서에 묶이지도 않습니다; GPL 때문에 유료 라이선스 없이는 독점 애드인에 넣을 수 없습니다.
- AEC Model Bridge에 적합한 사람은 누구입니까?
- 모든 변경에 사람의 승인이 필수인 환경에서, Revit 모델 사본으로 에이전트를 시범 운영할 의향이 있는 BIM 코디네이터와 디지털 실무 책임자.
- 팀이나 프로덕션 환경에서 AEC Model Bridge의 비용은 얼마입니까?
- 소프트웨어는 GPL로 무료입니다. 실제 비용은 실제 환경에서 실행하는 사람마다 필요한 Revit 구독, AI 클라이언트 요금제나 토큰, 그리고 매 세션 도구 219개 목록이 차지하는 컨텍스트입니다. 상용 라이선스 가격은 공개되어 있지 않습니다.
- AEC Model Bridge에 회사 데이터를 맡겨도 안전합니까?
- 서버와 애드인은 로컬에서 실행되며 브리지는 루프백에서만 대기합니다. 도구가 모델에서 읽은 내용은 AI 제공업체로 전송되며, 패널의 내장 채팅은 Anthropic으 로 보냅니다. 텔레메트리는 없습니다. 계획과 증빙 묶음은 요소 이름과 파라미터 값을 작업 폴더에 저장하며, 파일 접근은 MCP_REVIT_ALLOWED_DIRECTORIES로 제한됩니다.
답변 확인일: 2026년 10월 31일.