vn-revit-mcp

vn-revit-mcp

AI が Autodesk Revit を操作できるようにします。 InnoPro が開発した、無料のオープンソースです。

• ワンコマンドでインストールでき、マシン上のあらゆる AI に自動接続します：Claude、Cursor、VS Code Copilot、Gemini CLI、Codex、LM Studio...
• Claude、OpenAI、Gemini、DeepSeek、Qwen、Kimi、GLM... またはローカルで動作する AI とRevit 内ですぐにチャットできます。Claude Desktop 経由で、Free プランを含む Claude アカウントも利用できます。
• 各コマンドは 2 通りの方法で使えます： InnoPro タブのボタンをクリックする（入力フォームは自動生成）、または AI から呼び出す。
• 新しいコマンドは .cs ファイル 1 つで作成でき、ビルドは不要です。フォルダーに入れて、コマンドを再読み込みをクリックするだけです。または AI に作成を依頼できます。
• トークンを節約： AI にはよく使うコマンドだけを表示し、必要に応じて追加で参照します。結果は見やすい表形式で返されます。
• API がない作業にも対応： Revit の既存コマンドを実行し、ユーザーのようにビューを操作する「仮想の手」（例：寸法記入、作図）を使い、結果を自動で確認します。AI は画像を通じてビューを確認できます。
• Revit を深く理解： マシンにインストールされたバージョンの Revit API と The Building Coder の記事を参照でき、検証済みのスキルセット（revit_skill）を備えています。
• 自動更新とホットリロード： サーバー、アドイン、拡張機能を自動で最新版に更新します（SHA-256 を検証）。Revit を開いたままでも、終了することなく新しいバージョンに切り替わります。
• 拡張機能ストア： AI に一言伝えるだけで、コマンドセット（例：4D シミュレーション）を追加できます。
• マシン上で動作し、ネットワークポートは開きません。モデルを変更するコマンドは元に戻せます。Revit 2025 以降に対応しています。

インストール

最も簡単な方法は、AI にインストールを依頼することです。 Claude Code、Codex、Gemini CLI、Cursor、または Copilot（エージェントモード）に次のように入力します：

github.com/Innoprovn/vn-revit-mcp の手順に従って、Revit 用の vn-revit-mcp をインストールしてください

AI が自動でインストールし、vn-revit-mcp doctor で確認して、エラーがあれば自動で修正します（AI 向けの手順：llms.txt）。

または、手動でインストールします：

PowerShellを開いて実行します（管理者権限は不要です。Revit が起動中の場合は、初回は Revit を再起動して InnoPro タブを表示してください）：

irm https://raw.githubusercontent.com/Innoprovn/vn-revit-mcp/main/install.ps1 | iex

または、Releases から vn-revit-mcp-<phiên bản>-win-x64.zip をダウンロードし、 展開して Cai-dat.cmd をダブルクリックします。

Claude Desktop を使用する場合： Releases から vn-revit-mcp-<phiên bản>.mcpb をダウンロードし、 ダブルクリックします（または Claude Desktop → Settings → Extensions → Install Extension）。拡張機能は初回起動時に Revit アドインを自動インストールします。

完了です：Revit を開き、InnoPro タブを選択します。次の 3 通りの方法で使えます：

• Revit 内でチャット： Chat AI をクリックし、プロバイダーを選択して API キーを入力します。Claude、OpenAI、Gemini、DeepSeek、Qwen、Kimi、 GLM、MiniMax、OpenRouter、またはキー不要でローカル動作する AI（Ollama、LM Studio）を利用できます。
• Claude アカウント（Free、Pro、Max）： チャット欄で Claude Desktop (Free/Pro/Max) → 接続して Claude を開くを選択します。Free プランは利用上限が低めですが、試すには十分です。
• ログイン済みの Claude Code： チャット欄で Claude Code (ログイン中のアカウント) を選択すると、API キーなしで Revit 内ですぐに質問できます（マシンで利用中の Claude プランを使用します）。
• 外部 AI（Claude Desktop、Cursor、VS Code...）：インストール時に自動接続されます。AI アプリを再起動して質問してください。

詳しい手順：docs/huong-dan-su-dung.md。CAD からのモデリング：docs/dung-hinh-tu-cad.md。

作業	方法
AI クライアントを追加接続	Revit の システム → AI 接続ボタン
更新	自動：Revit または AI を起動するたびに、最大 12 時間に 1 回（SHA-256 を検証し、マーケットプレイスの拡張機能も自動で最新版に更新されます）。すぐに更新する場合：vn-revit-mcp.exe update。無効にする場合：環境変数 VN_REVIT_MCP_AUTO_UPDATE=0
アンインストール	zip ファイル内の uninstall.ps1（追加したコマンドもすべて削除するには -Purge を追加）
Revit の「Load Once」ダイアログ	インストーラーが vn-revit-mcp の選択をあらかじめ Always Load に設定するため、Revit は確認を求めません。Revit に確認させる場合：-NoTrust を指定してインストールします。コード署名：ポリシー

その他の AI クライアント：stdio 方式の MCP サーバーとして設定し、command に %LOCALAPPDATA%\InnoPro\vn-revit-mcp\current\server\vn-revit-mcp.exe を指定します。 複数の Revit を同時に開いている場合、AI は最後に操作した Revit で自動的に作業します。切り替えるには、AI に伝えてください（例：「Revit 2025 で作業して」）。

含まれる機能（100 以上のコマンド）

グループ	例
クエリ、パラメーター	プロジェクト／ビュー情報、選択中の要素、要素の検索、パラメーター、統計；パラメーターの一括編集
QA-QC	警告、重複要素（検索／削除）、空のパラメーター、干渉、リンクとの干渉、モデルの健全性、軸までの寸法
モデリング	レベル、通り芯グリッド、壁、梁、床、ファミリの配置；梁に沿った床、床の結合／分割、自動結合、壁仕上げ層
CAD モデリング	CAD 図面から壁、床／天井、柱、梁、杭＋杭頭、ドアを作成；断面から梁タイプを作成
Rebar	BBS スタイルの統計、クイック選択、ホストの解除／再接続、鉄筋の移動、干渉回避、鉄筋 QA、変更の比較、形状ライブラリ
図面	シートの作成、ビューの配置、ビューの複製、テンプレートの割り当て、自動タグ付け、通り芯寸法、PDF の書き出し
データ	集計表の読み取り／書き出し、材料数量、壁の長さ、シート一覧、リンク内の要素検索
高度な機能	run_csharp：AI が C# コードを実行；デフォルトは読み取り専用；mode=write でモデルを直接編集（Undo 可能）

すっきりとしたリボン：各グループには小さなボタンが数個だけあり、その他のコマンドはすべて すべて メニューにあります。ストア からコマンドを追加できます（コミュニティ提供）。

レシピ（MCP プロンプト。例：Claude で / を入力）：kiem-tra-chat-luong、boc-khoi-luong、dung-tang-luoi-truc、 viet-lenh-moi。各レシピは Markdown ファイルなので、誰でも追加できます。

新しいコマンドの作成

最も手軽な方法は .cs ファイルを 1 つ作ることです。プロジェクトもビルドも必要ありません。

public sealed class CountWalls : RevitCommandBase
{
    public override string Name => "count_walls";
    public override string Category => "Của tôi";
    public override string Description => "Đếm số tường trong mô hình.";
    public override RibbonButton Ribbon => new("Đếm\ntường", "#");   // có nút trên ribbon

    public override object Execute(RevitCommandContext context, JsonElement arguments) =>
        new { count = new FilteredElementCollector(context.Document).OfClass(typeof(Wall)).GetElementCount() };
}

%LOCALAPPDATA%\InnoPro\vn-revit-mcp\Scripts\ に入れて、コマンドを再読み込み をクリックします。コマンドにはボタンと入力フォームがあり、すぐに AI から呼び出せます。 コードがわからない場合は、viet-lenh-moi レシピを使うか、AI に 「vn-revit-mcp のコマンドを書いてください……」 と頼んでください。

詳しいガイド（3 段階：.cs ファイル、CommandSet、コントリビューション）：docs/viet-lenh-moi.md。 AI コーディングツール（Claude Code、Cursor、Copilot、Codex など）は AGENTS.md を参照してください。

アーキテクチャ

AI client ──MCP (stdio)──▶ vn-revit-mcp.exe ──named pipe──▶ Add-in InnoPro (trong Revit) ──▶ Revit API
Khung chat trong Revit ──────────────────────────────────────▲      ├─ CommandSet (DLL)
                                                                    └─ Scripts (*.cs, tự biên dịch)

コンポーネント	役割
src/InnoPro.Revit.Sdk	コマンド作成用インターフェース：RevitCommandBase、Args、Table、Lookup、UnitConvert
src/InnoPro.Revit.Loader	ローダー（InnoPro.Revit.Addin.dll）：Revit が直接読み込み、新しいバージョンがある場合はコアを自動でホットリロード
src/InnoPro.Revit.Addin	コア（InnoPro.Revit.Core.dll）：リボンの自動生成、フォームの自動生成、コマンドのホットロード、ブリッジ、チャットパネル
src/InnoPro.Revit.Chat	チャットモジュール（個別に読み込み）：Anthropic SDK 経由の Claude、その他の AI は OpenAI 互換 API 経由
src/InnoPro.Bridge	名前付きパイププロトコル、共通コマンド検索
src/InnoPro.Mcp.Server	MCP サーバー、レシピ、AI クライアントを設定する setup コマンド
src/InnoPro.Revit.Commands.*	同梱の CommandSet：Core、QA-QC、Modeling、Data、Code

詳細：docs/kien-truc.md。

開発者向け

.NET SDK 8 が必要です。

powershell -ExecutionPolicy Bypass -File scripts\install-dev.ps1   # build + cài bản "dev", cùng bố cục với người dùng
powershell -ExecutionPolicy Bypass -File scripts\dev-reload.ps1    # sửa CommandSet: Revit đang mở nạp lại ngay
powershell -ExecutionPolicy Bypass -File scripts\package.ps1       # đóng gói artifacts\release\*.zip

コア、SDK、Bridge、チャットモジュールもホットロードされます（Revit がアイドル状態のときにローダーがコアを自動で切り替えます）。ローダー（InnoPro.Revit.Loader）を変更する場合に限り、install-dev.ps1 を実行してから Revit を再起動する必要があります。

ロードマップ

フェーズ	内容	状態
P0	アドイン、InnoPro タブ、ブリッジ、MCP サーバー	✅
P1	CommandSet Core、QA-QC、Modeling、Data、Code；.cs ファイルからのコマンド；ボタンとフォームの自動生成；トークンの節約	✅（拡張中）
P2	Revit 内のマルチプロバイダー対応チャットパネル	✅ 初期版
P3	1 行インストーラー、AI クライアントの自動設定；GitHub、MCP Registry での公開、自動更新	✅
P4	専門コマンド（構造、Rebar、図面、CAD からの作図）；コミュニティコマンドストア	⏳

コントリビューション

誰でもコマンド、CommandSet、レシピを提供できます。issue または pull request を作成してください。

ライセンス

SignPath.ioによる無料のコード署名、SignPath Foundationの証明書（申請中）— コード署名ポリシー。

GPLv3にプラグイン例外が付属しています。CommandSetとコマンドファイルは独自のライセンスを維持し （ソースを非公開にすることも可能）、Autodesk Revitと組み合わせて実行できます。

一部のコマンドは、mcp-servers-for-revit（MIT）の仕様を参考にしています。 DWG/DXFファイル内の文字と引出線の読み取りには、ACadSharp（MIT）を使用しています。

---

英語

vn-revit-mcpを使うと、AIでAutodesk Revit 2025以降を操作できます。管理者権限不要の1行インストール： irm https://raw.githubusercontent.com/Innoprovn/vn-revit-mcp/main/install.ps1 | iex — 検出されたすべてのAIクライアント（Claude Desktop/Code、Cursor、VS Code、Windsurf、Gemini CLI、LM Studio、Codex CLI、Cline）にMCPサーバーを登録します。 Revit内のInnoProタブには、チャットペイン（Anthropic SDK経由のClaude、OpenAI互換API経由のOpenAI、Gemini、OpenRouter、Ollama、LM Studio）と、自動生成された入力フォーム付きの各コマンドのボタンが用意されています。 Scriptsフォルダーに単一の.csファイルを追加するだけでコマンドを追加できます。Revit内でコンパイルされ、ホットリロードされます。 ユーザーにこれをインストールするAIエージェント： llms.txtに従ってください（1行インストールの後、vn-revit-mcp doctor --jsonを実行し、各fixを適用します）。 ライセンスはGPLv3（プラグイン例外付き）です。コードに取り組むAIコーディングエージェントは、AGENTS.mdを参照してください。