Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.
English | 简体中文 | Español | हिन्दी | العربية | Português (BR) | Русский | 日本語 | Deutsch | Français | Bahasa Indonesia | Türkçe | 한국어 | Tiếng Việt | Italiano | Polski | 繁體中文
この文書は AI の支援で翻訳されたものです。内容は英語版の README が正であり、誤りや改善点があれば Pull Request でお寄せください。詳しくは CONTRIBUTING.md をご覧ください。
開いている Revit モデルについて AI に質問できます。デフォルトでは、プランを承認するまで書き込みツールはブロックされます。
Revit 2024 – 2027 向けのオープンソースの MCP サーバーとネイティブアドイン。Claude、Codex などの MCP クライアントで使えます。
AEC Model Bridge は、Claude、Codex、Cursor などの AI アシスタントが、開いている Revit モデルを読み取り・編集できるようにするオープンソースの Revit MCP サーバーです。変更はすべて、先にあなたが承認します。Python 製の MCP サーバーとネイティブの Revit アドインで構成され、読み取り専用ツールはすぐにモデルを調査でき、モデルの変更にはデフォルトで承認済みのプランが必要です。承認フローを見る。
セットアップ手順を用意しているのは、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 でプランを作成します。execute_plan が適用する前に、Revit のパネルで内容を確認します。IFC のレビューは Revit なしで実行できます。
スナップショットの QA/QC とレポートのモジュールには、互換性のある保存済みスナップショットが必要です。現在、Revit からモジュールへのスナップショットの受け渡しでは、ファイル名とワークスペースの整合が必要です。snapshot_id を省略すると、生成されたサンプルデータが返されることがあります。ライブの調査には、上記の Revit 用ツールを直接使ってください。今後の修正とデモ。
クイックスタート
ワンクリックインストール
ボタンに必要なのは 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 で再生成できます。
ティールの箱は現在動作するもの、アンバーの破線の箱は開発中のもの、インディゴの図形はデータと外部サービスです。
承認の仕組み
ハブは、承認済みのプランを伴わない限り、モデルを変更するツール呼び出しをすべて止めます。デフォルトのモードは required です。AI がプランを提案し、あなたが Revit のサイドパネルで確認すると、アドインが Revit のメインスレッド上で実行します。パラメータ編集やモデル編集のアクションはそれぞれ個別の名前付きトランザクションですが、保存・同期・スクリプトのアクションはそうではないため、Ctrl+Z では戻せません。
図のソース:approval-flow.mmd。画像は python scripts/render_diagrams.py で再生成できます。
プランが誤りだと分かった場合は、Revit の Ctrl+Z で元に戻してください。パラメータの書き込みはそれぞれ個別の名前付きトランザクションなので、1 つのプランで複数回押す必要があることがあります。プラン全体を 1 ステップで元に戻す機能は計画中で、まだ実装されていません。もう 1 つの方法は取り消しプランです。アシスタントが実行済みプランの証跡から plan_revert で作成し、ほかのプランと同様に承認します。rollback_plan は人専用で、ボタンでもコマンドでもないため、あてにしないでください。これらのいずれの方法も、実際の Revit セッションではまだ検証されていません(UNVERIFIED)。ファイル出力など元に戻せない操作はどの方法でも戻せず、再度の確認もまだ求めません(計画中)。パネルの 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 Developer Pack |
| 2025 | .NET 8 for Windows | .NET 8 SDK |
| 2026 | .NET 8 for Windows | .NET 8 SDK |
| 2027 | .NET 10 for Windows | .NET 10 SDK |
このほか、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 インストーラーは、scripts/build-installer.ps1 が Inno Setup で作成します。トラブルシューティングを含む詳しいガイドは 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"
}
}
}
}
MCP_REVIT_HOST_VERSION を省略すると、開いている最新の Revit インスタンスが対象になります。2024 や 2026 などの年を設定すると、そのクライアントのエントリを特定の Revit バージョンに固定できます。MCP_REVIT_BRIDGE_URL は、高度な構成でエンドポイントを上書きします。
VS Code では .vscode/mcp.json から始められます。Hermes Desktop では、プレースホルダーの Python パスを置き換えたうえで docs/examples/hermes-desktop.json から始められます。MCP Bundles に対応するクライアントは、最新リリースの .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に指定したフォルダー内でのみ読み書きします。 - 承認をオフにしない限り、モデルを変更するツールには承認済みのプランが必要です。
- ツール呼び出しは監査ログに記録され、機密情報はマスクされます。
詳細は 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 のパネルでプランが承認されるまでブロックされます。読み取り専用のツールは承認なしで実行されます。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 向けのアドインのターゲットをビルドします。Pull Request を作成する前に CONTRIBUTING.md をお読みください。
ドキュメント
- インストールガイド
- ツールリファレンス
- アーキテクチャ
- 設定リファレンス
- セキュリティ
- MCP クライアントとレジストリ
- バージョニングとリリース
- すべてのドキュメント
- コントリビューション と 行動規範
- コントリビューター
Built with
AEC Model Bridge stands on open-source work. It is independent and is not affiliated with or endorsed by any project named here.
- Model Context Protocol Python SDK (MIT) for the MCP server
- IfcOpenShell (LGPL-3.0-or-later) for IFC files
- specklepy (Apache-2.0) for Speckle
- pydantic, httpx, NetworkX, openpyxl and PyYAML (MIT or BSD)
- Anthropic Python SDK (MIT) for the built-in agent chat
- Serilog, IronPython and Microsoft WebView2 in the Revit add-in
- Autodesk Revit and Navisworks and McNeel Rhino are separate products that you license yourself. This project does not include their code.
Licence texts and the full list of packages are in THIRD_PARTY_NOTICES.md. Licences were read from package metadata; rows that could not be verified are marked as such.
プロジェクトとライセンス
メンテナー:A. Sam Mohammad。 LinkedIn | Issues