Autodesk Revit 내부의 경량 GraphQL API를 모두 읽고 작업 작성합니다. GraphQL 또는 Python 클라이언트에서 모델 데이터를 쿼리하고 선택/콘텍스트를 검사하고 안전한 편집 명령을 실행할 수 있습니다.

계정 만들기

하이라이트

• Revit 내부 처리 HTTP GraphQL 서버를 실행
• 모듈 쿼리 + mutation 아키텍처 (컨트리뷰터)
• 넓은 쿼리 적용 : 문서, 카테고리, 요소, 객실, 레벨, 전망, 가족 /instances, 프로젝트 정보, 자료, 워크스테이션, 단계, 디자인 옵션, 링크, 시트, 그리드, 일정, 프로젝트 위치, 경고, 요소 유형, 단위, 좌표, 카테고리 별 요소, 경계 상자, 활성보기 및 선택, 요소 관계, 모델 건강
• Practical mutations: 설정 매개 변수 (single/batch), 변경 유형, 이동, 회전, 삭제, 가족 인스턴스를 만들, 중복보기, 시트를 생성, Excel에서 /
• 간단한 건강 엔드포인트 및 네이티브 JSON 변수
• 자동화 및 AI 툴링을 위한 선택적인 Python MCP 클라이언트/서버

요구 사항

• Autodesk Revit 2021-2027 (다타겟). 2024/2025에 유효한 대부분의 특징.
• Revit 2021-2024에 대한 .NET Framework 4.8; Revit 2025-2026에 대한 .NET 8; .

RevitMCPGraphQL

Exposes a lightweight GraphQL API inside Autodesk Revit for both read and write operations. You can query model data, inspect selection/context, and run safe editing commands (mutations) — all from GraphQL or a Python client.

Demo

Highlights

• Runs an in-process HTTP GraphQL server inside Revit
• Modular query + mutation architecture (contributors)
• Broad query coverage: document, categories, elements, rooms, levels, views, families/instances, project info, materials, worksets, phases, design options, links, sheets, grids, schedules, project location, warnings, element types, units, coordinates, elements by category, elements in bounding box, active view and selection, element relationships, model health
• Practical mutations: set parameters (single/batch), change type, move, rotate, delete, create family instance, duplicate view, create sheet, export/import schedules to/from Excel
• Simple health endpoint and native JSON variables
• Optional Python MCP client/server for automation and AI tooling

Requirements

• Autodesk Revit 2021–2027 (multi-targeted). Most features validated on 2024/2025.
• .NET Framework 4.8 for Revit 2021–2024; .NET 8 for Revit 2025–2026; .NET 10 for Revit 2027 (handled by csproj configurations)
• Windows 10/11
• Python 3.8+ (only if using the Python client / MCP server)

Install and Build

1. Clone

   • git clone https://github.com/chuongmep/RevitMCPGraphQL.git

2. Open the solution in Rider or Visual Studio

3. Restore and build

   • dotnet restore
   • Select the Revit configuration matching your version (e.g., “Debug R24”, “Debug R25”, “Debug R26”, or “Debug R27”) and build

4. Deploy

   • The project uses Nice3point.Revit.Build.Tasks to copy the .addin and binaries to your Revit Addins folder on Debug builds automatically

Run in Revit

• Start Revit and open a model
• In the Add-Ins tab, use the Start button to launch the server (Stop to shut it down)
• A free port between 5000–6000 is chosen automatically; a dialog shows the exact URL
  • Health: http://localhost:/ or /health
  • GraphQL: http://localhost:/graphql (POST)

Tip: If you rely on a fixed port (e.g., tests), set REVIT_GRAPHQL_URL to the shown URL when launching tools.

GraphQL usage

Send HTTP POST to /graphql with JSON body: { “query”: “{ health }” }

Variables are supported via the standard { query, variables } payload.

Queries (selection)

• health: String
• document
• categories(limit)
• elements(limit)
• familyTypes(limit)
• rooms(limit)
• levels(limit)
• views(limit)
• families(limit)
• familyInstances(limit)
• projectInfo
• elementsById(ids: [ID!]!)
• materials(limit)
• worksets(limit)
• phases(limit)
• designOptions(limit)
• links(limit)
• sheets(limit)
• grids(limit)
• projectLocation
• warnings
• elementTypes(limit)
• elementsByCategory(category: BuiltInCategoryEnum!, limit)