Autodesk Revit Mcp Server

ステータス：開発ブランチにあり、まだリリースされていません。

AEC Model Bridgeは、Claude、Codex、CursorなどのAIアシスタントが、開いているRevitモデルを読み取り、編集できるオープンソースのRevit MCPサーバーです。デフォルトでは、変更を加える前に毎回承認が必要です。Python MCPサーバーとネイティブRevitアドインの2つの部分で構成されています。読み取り専用ツールはすぐにモデルを調査できます。デフォルトでは、モデルの変更には承認済みの計画が必要です。 承認フローを見る。

対象ユーザー。 モデル品質の確認、影響を受ける要素の特定、パラメーター修正の準備をAIアシスタントに任せつつ、すべての変更を人が管理したいBIMコーディネーターやマネージャー向けです。スクリプトを書く必要はありません。

ステータスと制限。 これはリリース前のソフトウェアです。

• この製品は、ライブのRevitセッションでまだ検証されていません。Pythonサーバーはモックプロバイダーでテストされており、CIではRevit 2024～2027向けにアドインをコンパイルしますが、Revitは起動しません。ここに記載されているRevitの動作はすべて、人が確認するまでは未検証として扱ってください。確認項目の一覧はリリースチェックリストをご覧ください。
• このページは開発ブランチについて説明しています。最新のGitHubリリースには、ここに記載されている内容がすべて含まれていない場合があります。
• まずプロジェクトのコピーで試してください。計画を承認すると、開いているモデルが変更されます。
• 既知の制限がいくつかあります。承認の仕組みおよびdocs/security.mdに記載されています。
• 開発ブランチでは、より多くのツールが登録されます（執筆時点ではモックモードで241個。開発ブランチを参照してください）。

Star History

Claude Desktop、GitHub Copilot を使用する VS Code、Cursor、Codex 向けのセットアップ手順を記載しています。このサーバーは標準的な MCP stdio サーバーなので、Claude Code、Windsurf、Cline、Continue、Zed、Gemini CLI などのほかのクライアントでも動作するはずです。互換性のページでは、手順が記載されているものと、テストされていないものを確認できます。

同じサーバーで IFC ファイルの検査、Rhino と Grasshopper の自動化、Speckle への接続もできます。統合状況では、利用可能なプロバイダーと、現在開発中のプロバイダーを確認できます。

ワークフローの例

BIM コーディネーター向け：モデルの品質を確認し、影響を受ける要素をレビューして、パラメーターの修正を承認した後、結果を確認してレポートをエクスポートします。以下の例では、現在のカタログに掲載されているツールを使用します。

ワークフロー	リクエストの例	使用するツール
モデルレビュー	"アクティブなドキュメントを表示し、警告を一覧表示して、影響を受ける要素を見つけてください。"	revit_get_document_info, revit_get_warnings, revit_get_elements_by_type
パラメーターの更新	"Level 02 の壁を見つけて、Comments の値を表示し、一括更新を提案してください。"	revit_get_elements_by_type, revit_get_element_parameters, revit_batch_set_parameters
図面作成	"この CSV からシート一覧を作成し、続けてシートの作成とビューの配置を提案してください。"	revit_batch_create_sheets_from_csv, revit_place_viewport_on_sheet
IFC レビュー	"この IFC ファイルの階を表示し、壁のプロパティを確認して、スキーマ検証の問題を報告してください。"	ifc_get_spatial_structure, ifc_get_properties, ifc_validate

Revit で初めて実行する場合は、次を試してください。

Read the active model's warnings. Group them by description and show the
affected element IDs. Then suggest which issues to investigate first.

続いて、プロジェクトに合わせてレベルと値を置き換え、パラメーターを修正してみてください。

Find walls on Level 02 and show their current Comments values. Propose setting
Comments to "Coordination reviewed" for the elements I choose. After I approve
the plan in Revit, apply it and read the values back to confirm the result.

編集の場合、アシスタントは plan_actions を使って計画を作成します。Revit パネルで内容を確認し、その後に限り execute_plan が適用します。IFC のレビューは Revit なしで実行できます。

スナップショット QA/QC モジュールとレポートモジュールには、互換性のある保存済みスナップショットが必要です。現在、Revit からこれらのモジュールへの引き渡しでは、ファイル名とワークスペースを一致させる必要があります。snapshot_id を省略すると、これらのモジュールのほとんどはブリッジモードで明確なメッセージを表示して処理を拒否し、モックモードでは生成されたサンプルデータのみを返すようになりました。まだこのガードが適用されていないモジュールもあるため（model_bloat など）、必ず snapshot_id を渡してください。ライブ検査には、上記の Revit 直接操作ツールを使用してください。 修正予定とデモ。

クイックスタート

Revit を使わずに 60 秒で始める（モックモード）

1. uv をインストールします。
2. 「手動セットアップ」の JSON を使ってサーバーをクライアントに追加し、 "MCP_REVIT_MODE": "mock" を設定します。以下のワンクリックボタンでは bridge モードで起動します。このモードでは Revit が必要です。
3. クライアントを再起動し、AEC Model Bridge のツールを一覧表示するよう依頼します。
4. アクティブなドキュメントを読み取るよう依頼します。モックモードでは生成されたサンプルデータが返され、モデルのデータは一切使用されません。そのため、Revit に接続する前にツールと承認フローを確認できます。
5. 独自のモデルを使うには、Revit アドインをインストールし （インストール手順）、モードを bridge に切り替えます。

ワンクリックインストール

ボタンを使うには uv が必要です。それ以外は不要です。独自の設定をしない場合、サーバーは ~/Documents/AEC Model Bridge をワークスペースとして使用します。Claude Desktop の場合は、最新リリースから .mcpb ファイルをダウンロードして開いてください。Revit で実際に作業するには Revit と アドインが必要です。モックモードではどちらも必要ありません。

手動セットアップ

Revit のライブ自動化には、Windows、ライセンス認証済みの Revit 2024～2027、 Python 3.11 以降、uv、および Revit アドイン （インストール手順）が必要です。次に、以下を claude_desktop_config.json に追加してください（Codex、Cursor、VS Code でも同じ値を使用します。 2 つのディレクトリ変数は省略可能で、省略した場合は上記のワークスペースが既定値になります）。

{
  "mcpServers": {
    "aec-model-bridge": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Sam-AEC/aec-model-bridge#subdirectory=packages/mcp-server-revit",
        "aec-model-bridge"
      ],
      "env": {
        "MCP_REVIT_MODE": "bridge",
        "MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
        "MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
      }
    }
  }
}

Revit を使わず、まずツールを確認しますか？ "MCP_REVIT_MODE": "mock" を設定してください。 サーバーは任意のマシンで起動し、スキーマとともにすべてのツールを一覧表示して、 定型の応答を返します。モデルにはアクセスしません。同じモック モード用の Dockerfile がリポジトリのルートにあります（docker build -t aec-model-bridge . を実行し、続けて docker run -i --rm aec-model-bridge を実行してください）。

VS Code をお使いですか？拡張機能のソースとローカルインストール手順 では、MCP サーバーを登録し、Revit の接続状態を表示します。拡張機能は Marketplace に公開されていません。

ツールの概要

分野	ツール	説明
Revit	103	モデルの読み取り、要素、パラメーター、ビュー、シート、集計表、エクスポート、ワークシェアリングの作成と編集
承認	6	モデル変更の計画、レビュー、承認、実行、ロールバック
モジュール	34	スナップショットの検査、パラメーターグリッド、QA/QC チェック、レシピ、レポート、選択
Rhino と Grasshopper	19	ジオメトリ、レイヤー、マテリアル、ブーリアン演算
Speckle	17	プロジェクト、モデル、バージョン、送信と受信
Navisworks	15	モデルツリー、視点、干渉テスト（開発中）
IFC	7	Revit を使わずに IFC ファイルを読み取り：構造、プロパティ、検証
グラフ、スナップショット、エクスポート、ジョブ	18	セマンティックグラフの監査、スナップショットの差分、SQLite エクスポート、バックグラウンドジョブ

既定のセットアップでは 219 個のツールが一覧表示されます（モックモードで現在のサーバーを使ってカウント）。 Autodesk Data ツールは、APS の認証情報が設定されている場合に表示されます。 ツールリファレンスには、すべてのツールが記載されています。各ツールには MCP アノテーション（readOnlyHint、destructiveHint、idempotentHint、 openWorldHint）が付いているため、クライアントは読み取りと書き込みを区別できます。

高度な Revit 自動化

モデルのクエリやパラメーターの更新に加え、Revit ツールでは建築要素、ビュー、シート、集計表、タグ、寸法を作成し、IFC、DWG、画像、Navisworks ファイルをエクスポートできます。対応している操作と入力については、ツールリファレンスをご覧ください。

ツールカタログで対応していない操作には、revit_invoke_method、revit_reflect_get、revit_reflect_setを使用して、公開されているRevit APIメンバーを操作できます。revit_execute_pythonはRevit内でIronPythonを実行します。これらの高度なツールには、Revitプロセスと同じ権限があります。信頼できるMCPクライアントとプロンプトでのみ使用してください。

仕組み

MCPクライアントは、1つのPythonハブと通信します。ハブは各呼び出しを、そのツールを担当するプロバイダーに送ります。デスクトップアプリ用のプロバイダーは、localhost経由でアプリ内の小さなアドインと通信します。

_{図のソース：architecture.mmd。画像を再生成するには、python scripts/render_diagrams.pyを実行してください。}

青緑色のボックスは現在利用できます。琥珀色の破線ボックスは開発中です。藍色の図形はデータと外部サービスを表します。

承認の仕組み

簡単に説明すると、次のとおりです。

• 使用するモードは2つです。 look_only ではアシスタントは読み取りのみ可能で、モデルを変更するすべてのツールが拒否されます。ask_first（デフォルト。required とも表記されます）では変更案を作成できますが、人が承認するまで何も実行されません。3つ目の値である auto はチェックを無効にするもので、管理されたパイプラインでのみ使用します。
• 承認できるのは人だけです。 AI クライアントには、計画の承認、却下、ロールバックの機能は提供されません。Revit パネルまたは aec-model-bridge-approve コマンドで人が承認します。
• 何も自動では適用されません。 承認済みの計画に含まれる承認済みアクションと一致する場合に限り、変更が1回だけ実行されます。
• 元に戻す操作はアクションごとです。 Revit の Ctrl+Z を押すたびに、1つのアクションが元に戻ります。

ハブは、承認済みの計画が付与されていない限り、モデルを変更するツール呼び出しをすべて停止します。AI が計画を提案し、あなたが確認した後、アドインが Revit のメインスレッドで実行します。パネルの Plans リストには、各保留中の計画のツール、引数、および取得されている場合は変更前の値が表示されます。推論やアシスタントが添付した警告を含む計画の詳細を確認するには、aec-model-bridge-approve show <plan_id> を実行してください。パネルにはその確認テキストは表示されません。パラメーター変更やモデル編集の各アクションは、それぞれ名前付きトランザクションで実行されます。保存、同期、スクリプトなど一部のアクションはトランザクションを使用しないため、Ctrl+Z では元に戻せません。

_{図のソース：approval-flow.mmd。python scripts/render_diagrams.py で画像を再生成できます。}

計画に誤りがあることがわかった場合は、Revit の Ctrl+Z で元に戻してください。各パラメーターの書き込みは個別の名前付きトランザクションであるため、1つの計画を元に戻すのに複数回押す必要がある場合があります。計画全体を1回の操作で元に戻す機能は、実装予定ですが、まだ実装されていません。もう1つの方法は復元計画です。アシスタントが実行済みの計画の証跡から plan_revert を使って作成し、他の計画と同様に承認します。rollback_plan も記録された変更前の値を逆順に書き戻し、変更前の値が記録されていないアクションをスキップできますが、人専用の機能であり、パネルのボタンもコマンドラインコマンドもまだありません。そのため、これに頼らないでください。これらの方法はいずれも、実際の Revit セッションではまだ検証されていません（未検証）。ファイル出力など元に戻せない操作は、これらの方法のいずれでも元に戻せず、二度目の確認もまだありません（実装予定）。パネルの Plans リストには保留中の計画のみが表示されます。aec-model-bridge-approve show <plan_id> はどの状態の計画にも使えますが、proofs/ バンドルが存在するのは実行済み（または実行を試みた）計画のみです。ライフサイクルについてはADR 0008を参照してください。

無人パイプラインでは、MCP_REVIT_APPROVAL_MODE=auto を設定できます。これにより人による確認が無効になるため、管理された環境でのみ使用してください。

対応している Revit バージョン

Revit バージョン	アドインのターゲット	ビルドツール
2024	.NET Framework 4.8	.NET 8 SDK および .NET Framework 4.8 開発者パック
2025	.NET 8 for Windows	.NET 8 SDK
2026	.NET 8 for Windows	.NET 8 SDK
2027	.NET 10 for Windows	.NET 10 SDK

これらがビルドターゲットです。CI では 4 つすべての年のアドインをコンパイルしますが、実際の Revit セッションで検証済みの年はまだありません。

また、Windows 10 または 11、Python 3.11 以降、および使用するバージョンのライセンス済み Revit インストールが必要です。モックモードでは Revit を使わずにサーバーを実行でき、開発やテストに便利です。

その他の連携機能

連携機能	状況
Revit	利用可能です。ネイティブ C# アドインです。
IFC（IfcOpenShell）	利用可能です。Revit を起動せずに IFC ファイルを読み込みます。
Rhino と Grasshopper	利用可能です。localhost:3004 の Rhino アドインに接続します。
Speckle	利用可能です。環境に Speckle クライアント ID が必要です。
Navisworks Manage	開発中です。プロバイダーとそのツールは登録済みですが、Navisworks アドインは未完成です。
Power BI	開発中です。プロバイダーとツールは存在しますが、ハブには登録されていません。
Excel、Parquet、DuckDB	予定されています。

製品名とロゴの権利は各所有者に帰属します。バナーでは、このプロジェクトが連携する製品を示す目的でのみ使用しています。

Revit アドインをインストールする

最も簡単な方法（Windows）： 最新リリースからAECModelBridge-Setup-<version>.exeをダウンロードし、ダブルクリックして、使用する Revit バージョンを選択してから Revit を再起動します。アドインと同梱の Python サーバーがインストールされます。チェックボックスをオンにすると、Claude Desktop と VS Code も設定され、その前に現在の設定がバックアップされます。アンインストールするには、Windows の設定を使用してください。以下の手順はソースからビルドする場合のものです。

インストールするのは、Python MCP サーバーと Revit アドインの 2 つです。Revit のライブ自動化には両方が必要です。

1. MCP サーバーをインストールする

git clone https://github.com/Sam-AEC/aec-model-bridge.git
cd aec-model-bridge

py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e packages/mcp-server-revit

2. Revit アドインをインストールする

Revit のインストールに合わせてバージョンを設定します。Windows がダウンロードしたスクリプトをブロックする場合は、各 .ps1 ファイルを右クリックして「プロパティ」を開き、実行する前に「ブロックの解除」を選択してください。

$RevitVersion = Read-Host "Revit year (2024, 2025, 2026, or 2027)"

.\scripts\package.ps1 -RevitVersion $RevitVersion
.\scripts\install.ps1 -RevitVersion $RevitVersion

インストーラーは、バージョンごとのバイナリを次の場所に配置します。

C:\ProgramData\AECModelBridge\bin\<year>

アドインのマニフェストは、ユーザーごとに次の場所へインストールされます。

%APPDATA%\Autodesk\Revit\Addins\<year>

install.ps1 に -AllUsers を指定すると、代わりにマニフェストをC:\ProgramData\Autodesk\Revit\Addins\<year>にインストールできます。

対応しているすべてのバージョンのバイナリを一度に準備するには、次のようにします。

.\scripts\package.ps1 -RevitVersion All

各GitHub リリースには、Revit の年ごとのパッケージが用意されています。たとえば、aec-model-bridge-revit-2026-<version>.zipです。解凍して、ソースからビルドする代わりに.\install.ps1 -RevitVersion 2026を実行してください。ダブルクリックで実行できる Windows インストーラーは、Inno Setup を使ってscripts/build-installer.ps1でビルドできます。トラブルシューティングを含む完全なガイドは、docs/install.mdにあります。

Claude Desktop を Revit に接続する

サーバーを MCP クライアントの設定に追加します。Claude Desktop の場合は、 claude_desktop_config.json の mcpServers セクションに追加します。Codex、Cursor、VS Code などの MCP クライアントでは、それぞれの設定形式で同じ command、args、env の値を使用します。

仮想環境の Python 実行ファイルを使用し、サーバーがアクセスできるワークスペース フォルダーを選択します。

{
  "mcpServers": {
    "aec-model-bridge": {
      "command": "C:\\path\\to\\aec-model-bridge\\.venv\\Scripts\\python.exe",
      "args": ["-m", "revit_mcp_server.mcp_server"],
      "env": {
        "MCP_REVIT_MODE": "bridge",
        "MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
        "MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
      }
    },
    "aec-model-bridge-revit-2026": {
      "command": "C:\\path\\to\\aec-model-bridge\\.venv\\Scripts\\python.exe",
      "args": ["-m", "revit_mcp_server.mcp_server"],
      "env": {
        "MCP_REVIT_MODE": "bridge",
        "MCP_REVIT_HOST_VERSION": "2026",
        "MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
        "MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
      }
    }
  }
}

最新の Revit インスタンスを対象にするには、MCP_REVIT_HOST_VERSION を省略します。 クライアントのエントリーを特定の Revit バージョンに固定するには、2024 や 2026 などの年を設定します。 MCP_REVIT_BRIDGE_URL は、高度な設定でエンドポイントを上書きします。

VS Code ユーザーは .vscode/mcp.json から設定を始められます。Hermes Desktop ユーザーは、プレースホルダーの Python パスを置き換えたうえで、 docs/examples/hermes-desktop.json から設定を始められます。MCP バンドルに対応するクライアントでは、 最新リリースから .mcpb ファイルをインストールできます。 サーバーは実行中のデスクトップアプリケーションと通信するため、Revit アドインは引き続き必要です。

接続を確認する

アドインのインストール後に Revit を再起動し、モデルを開いて、次を実行します。

$registry = Get-ChildItem "$env:LOCALAPPDATA\AECModelBridge\registry\revit-*.json" | Select-Object -First 1
$switch = Get-Content $registry.FullName -Raw | ConvertFrom-Json
Invoke-RestMethod "$($switch.endpoint)/health"

応答には healthy と実行中の Revit のバージョンが表示されます。Revit で AEC Bridge リボンタブを確認してください。Workflows パネルには、Open Panel、 Health Check、Pending Actions、Reports があります。Tools パネルには、Config、Help、 About があります。

セキュリティ

• Revit ブリッジは localhost のみで待ち受けます。
• サーバーが読み書きするのは、 MCP_REVIT_ALLOWED_DIRECTORIES に指定されたフォルダー内のみです。
• 変更を伴うツールには、承認を無効にしない限り、承認済みのプランが必要です。また、 look_only モードでは、それらのツールは一切実行されません。
• 承認は、チャネル（パネルまたはコマンドライン）とオペレーティングシステムのアカウントとともに記録されます。 誰が入力しているかを証明するものではないため、プランを承認するアカウントで AI クライアントにシェルを使用させないでください。
• ツールの呼び出しは監査ログに記録され、シークレットはマスキングされます。

詳細は docs/security.md を参照してください。脆弱性を報告するには、 SECURITY.md の手順に従ってください。

FAQ

Revit 用 MCP サーバーとは何ですか？

Model Context Protocol（MCP）は、AI アシスタントがほかのソフトウェアのツールを 呼び出せるようにするオープン標準です。Revit 用 MCP サーバーは、Revit の操作を ツールとして公開します。アシスタントがツールを選び、アドインが Revit 内で実行します。

どの AI アシスタントが使えますか？

ローカルの stdio サーバーを起動できる MCP クライアントであれば、どれでも使用できます。 Claude Desktop、GitHub Copilot を備えた VS Code、Cursor、Codex、および標準の mcpServers 設定を読み込むクライアント向けに、セットアップ手順を用意しています。Windsurf、Cline、Roo Code、 Continue、Zed、Claude Code、Gemini CLI も同じ方法で動作するはずですが、テストはしていません。 互換性を参照してください。パネルのチャットでは、Anthropic API キー、 またはインストール済みの claude や codex コマンドラインツールも使用できます。 ADR 0012を参照してください。

AI が確認なしにモデルを変更することはありますか？

デフォルトモードではありません。モデルを変更するツールは、Revit パネルまたは aec-model-bridge-approve コマンドで人がプランを承認するまでブロックされます。 読み取り専用ツールは承認なしで実行されます。look_only モードでは、モデルを変更する操作は 一切実行されません。MCP_REVIT_APPROVAL_MODE=auto を設定すると、承認が省略されます。

モデルはクラウドに送信されますか？

サーバーとアドインはお使いのマシン上で実行され、ブリッジは localhost で待ち受けます。 AI アシスタントにはツールの戻り値が渡され、その結果はクライアントの背後にあるモデルプロバイダーに送られます。 Speckle などのクラウドプロバイダーは、設定してそのツールを呼び出した場合にのみ実行されます。

Revit なしで IFC ファイルを扱えますか？

はい。IFC プロバイダーは IfcOpenShell でファイルを読み込みます。ファイルのメタデータ、 空間構造、要素のプロパティ、境界ボックスを返し、クラス、GUID、名前、プロパティによるクエリを実行して、 スキーマを検証できます。IFC ファイルは編集しません。

Revit をインストールせずに使用できますか？

モックモードでのみ使用できます。モックモードは開発とテストを目的としています。実際のモデルを操作するには、Revit 2024～2027 とアドインが必要です。

リリースとバージョン

AEC Model Bridge はセマンティックバージョニングに従っています。リリースには GitHub で vX.Y.Z のタグが付けられ、ルートの VERSION ファイルにバージョン番号が記載されています。リリースプロセスについてはdocs/versioning.mdを、各バージョンの変更内容についてはCHANGELOG.mdをご覧ください。

開発

# Python tests
python -m pytest packages/mcp-server-revit/tests

# Build one Revit version, for example 2026
.\scripts\build-addin.ps1 -RevitVersion 2026 -Configuration Release

# Build all supported versions
.\scripts\package.ps1 -RevitVersion All

CI では、Python サーバーと Revit 2024～2027 向けのアドインがビルドされます。プルリクエストを作成する前に、CONTRIBUTING.mdをご覧ください。

ドキュメント

• インストールガイド
• ツールリファレンス
• アーキテクチャ
• 設定リファレンス
• セキュリティ
• MCP クライアントとレジストリ
• バージョニングとリリース
• リリースチェックリスト
• インストール後の初回確認
• デモ実行手順書
• 証跡バンドルと復元プラン
• プライバシー
• ロードマップ
• すべてのドキュメント
• コントリビューションガイドと行動規範
• コントリビューター

使用技術

AEC Model Bridge はオープンソースの成果を基盤としています。独立したプロジェクトであり、ここに記載されているいずれのプロジェクトとも提携関係になく、推奨を受けているものでもありません。

• MCP サーバー向けの Model Context Protocol Python SDK（MIT）
• IFC ファイル向けの IfcOpenShell（LGPL-3.0-or-later）
• Speckle 向けの specklepy（Apache-2.0）
• pydantic、httpx、NetworkX、openpyxl、PyYAML（MIT または BSD）
• 組み込みのエージェントチャット向けの Anthropic Python SDK（MIT）
• Revit アドインで使用する Serilog、IronPython、Microsoft WebView2
• Autodesk Revit、Navisworks、McNeel Rhino は、それぞれ個別の製品であり、ライセンスはご自身で取得してください。このプロジェクトにそれらのコードは含まれていません。

ライセンスの全文とパッケージの一覧は、THIRD_PARTY_NOTICES.mdに記載されています。ライセンスはパッケージのメタデータを参照しており、確認できなかった項目にはその旨が記されています。

プロジェクトとライセンス

A. Sam Mohammadがメンテナンスしています。 LinkedIn | Issues

Revit リンク例外付き GPL-3.0-or-later、または商用ライセンス。