Autodesk Revit 内の軽量な GraphQL API を公開し、読み込みと書き込みの両方の操作を行います。 モデルのデータをクエリしたり、選択/コンテキストを調べたり、安全な編集コマンド(mutations)を実行したりできます。すべての GraphQL や Python クライアントから。

デモデモ

##ハイライト

• Revit 内の HTTP GraphQL サーバを実行
• モジュラークエリ+変異アーキテクチャ(コントリビューター)
• 広範なクエリカバレッジ:文書、カテゴリ、要素、部屋、レベル、ビュー、家族/インスタンス、プロジェクト情報、材料、ワークセット、フェーズ、設計オプション、リンク、シート、グリッド、スケジュール、プロジェクトの場所、警告、要素タイプ、ユニット、座標、カテゴリ別要素、境界ボックス、アクティブなビューと選択、要素の関係、モデル健康
• 実用的なミューテーション: パラメータ(単一/バッチ)を設定、タイプを変更、移動、回転、削除、家族インスタンスの作成、重複ビューの作成、シートの作成、エクスポート/インポートのスケジュールをExcelから/へ
• シンプルな健康エンドポイントとネイティブJSON変数
• 自動化およびAIの工具細工のための任意Python MCPの顧客/サーバー

要件

• Autodesk Revit 2021～2027(マルチターゲット) 2024/2025で検証されているほとんどの機能。
• .NET Framework 4.8 Revit 2021–2024; .NET 8 再生 2025–2026; .

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)