Skip to main content
Glama

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 ファイルとして保存されます。

サポー卜対象の操作

操作

ステータス

wall.create

✅ サポー卜

wall.update

✅ サポー卜

element.move

✅ サポー卜

element.rotate

✅ サポー卜

element.delete

✅ サポー卜

element.rename

✅ サポー卜

parameter.set

✅ サポー卜

parameter.set_many

✅ サポー卜

door.insert

✅ サポー卜

window.insert

✅ サポー卜

room.create

✅ サポー卜

view.create_plan

✅ サポー卜

sheet.create

✅ サポー卜

sheet.place_view

✅ サポー卜

document.save

✅ サポー卜

document.save_as

✅ サポー卜

export.pdf

✅ サポー卜

export.dwg

✅ サポー卜

MCP ツール

ツール

説明

revit_get_status

接続ステータスとドキュメント情報

revit_get_capabilities

プロトコルバージョン、メソッド、操作

revit_inspect_document

アクティブドキュメントの識別情報

revit_inspect_selection

現在の選択項目

revit_query_elements

構造化された要素クエリ

revit_validate_plan

実行せずに検証

revit_preview_plan

ドライランでの解決

revit_commit_plan

トランザクション内で実行

revit_get_job_status

ジョブのステータスと結果

revit_cancel_job

キュー済み/実行中のジョブをキャンセル

revit_rollback_job

完了したジョブをロールバック

revit_get_audit_log

サニタイズされた監査エントリ

主要な設計判断

  1. バックグラウンドスレッドから Revit API を呼び出さない — すべての Revit API 呼び出しは ExternalEvent ディスパッチャーを経由します

  2. アトミックな実行 — プランは単一の TransactionGroup 内で実行され、失敗時にはロールバックされます

  3. 構造化されたエラー — すべての失敗は安定したエラーコーを保持します

  4. 単位の安全性 — すべての長さには明示的な単位が付与され、ハードコーされた / 304.8 は使用しません

  5. 型の安全性 — タイプ/レベルの解決は決定的であり、ランダムな FirstElement() は使用しません

  6. パスの安全性 — Export/SaveAs パスは正規化され、パストラバーサルがチェックされます

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

ドキュメント

ライセンス

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers