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 を設定

Antigravity 設定に MCP サーバーを追加します：

{
  "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 パスは正規化され、パストラバーサルがチェックされます

7. 確認トークン — 破壊的な操作には人間の承認が必要です

ドキュメント

• アーキテクチャ

• セキュリテイ

• コマンド

• トラブールシューティング

• Revit 2024 開発

• Autodesk への拡張

• 手動テストチェックリスト

ライセンス

MIT