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 を設定
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 ツール
ツール | 説明 |
| 接続ステータスとドキュメント情報 |
| プロトコルバージョン、メソッド、操作 |
| アクティブドキュメントの識別情報 |
| 現在の選択項目 |
| 構造化された要素クエリ |
| 実行せずに検証 |
| ドライランでの解決 |
| トランザクション内で実行 |
| ジョブのステータスと結果 |
| キュー済み/実行中のジョブをキャンセル |
| 完了したジョブをロールバック |
| サニタイズされた監査エントリ |
主要な設計判断
バックグラウンドスレッドから Revit API を呼び出さない — すべての Revit API 呼び出しは ExternalEvent ディスパッチャーを経由します
アトミックな実行 — プランは単一の TransactionGroup 内で実行され、失敗時にはロールバックされます
構造化されたエラー — すべての失敗は安定したエラーコーを保持します
単位の安全性 — すべての長さには明示的な単位が付与され、ハードコーされた
/ 304.8は使用しません型の安全性 — タイプ/レベルの解決は決定的であり、ランダムな
FirstElement()は使用しませんパスの安全性 — Export/SaveAs パスは正規化され、パストラバーサルがチェックされます
確認トークン — 破壊的な操作には人間の承認が必要です
ドキュメント
ライセンス
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.1359 npmMIT
- 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