MCP Servers For Revit

mcp - servers - for - revitは、モデルコンテキストプロトコル（MCP）を通じてAIアシスタントとAutodesk Revitを接続するオープンソースプロジェクトで、AIクライアントがRevitプロジェクト内の要素を読み取り、作成、変更、削除できるようにします。

開発者ツール教育と学習ツール #Revit統合 #AIアシスタント #建築モデリング #MCPプロトコル .C#

スコア : 2.5ポイント

ダウンロード数 : 0

更新時間 : 2026-03-13

サイトを開く

mcp-servers-for-revitとは？

mcp-servers-for-revitは革新的なツールセットで、ClaudeやClineなどのAIアシスタントが直接Autodesk Revitソフトウェアとやり取りできるようにします。例えば、自然言語でAIアシスタントに「2階に窓を追加して」や「すべての壁の材料使用量を集計して」と指示すると、AIがRevit内でそれらの操作を直接実行できます。このツールは3つの部分で構成されています：AIと通信するサーバー、Revit内部で動作するプラグイン、および具体的な操作を実行する機能モジュール。これらが協調して、あなたの自然言語の指示をRevitが理解できる操作に変換します。

mcp-servers-for-revitの使い方は？

使用方法は非常に簡単です： 1. Revitプラグインをインストールします（指定のフォルダにファイルをコピーするだけ） 2. AIクライアント（Claude Desktopなど）でMCPサーバーを設定します 3. Revitを起動すると、プラグインが自動的に読み込まれます 4. AIチャット画面で、自然言語でRevitモデルを操作できます全体のプロセスでコードを書く必要はありません。AIがあなたの意図を理解し、対応するRevit操作を実行します。

適用シーン

このツールは以下のシーンに特に適しています： • 迅速なモデル修正：自然言語で建築モデルを迅速に調整する • 一括操作：複数の要素に対して同じ操作を一度に実行する • データ抽出：モデルの統計情報や材料使用量などを迅速に取得する • 自動注釈：壁や部屋などに自動的にラベルを付ける • モデル分析：AIにモデルの複雑さを分析し、最適化提案を行ってもらう • 教育デモ：学生や顧客にRevitの操作手順を示す

主要機能

要素のクエリと分析

Revitモデル内のさまざまな要素をスマートにクエリし、詳細情報を取得し、モデルの複雑さを集計し、材料使用量を計算するなどができます。AIはあなたのクエリ意図を理解し、正確な結果を返します。

要素の作成と変更

さまざまな建築要素を作成します：壁、窓、ドア、梁、柱、床、屋根など。点ベース、線ベース、面ベースなどのさまざまな作成方法をサポートし、AIはあなたの説明に基づいて最適な作成方法を選択します。

注釈とラベル

モデル要素に自動的に寸法注釈、部屋ラベル、壁ラベルなどを付けます。一括処理が可能で、注釈の効率を向上させます。

データ管理

部屋データをエクスポートし、プロジェクト情報をローカルデータベースに保存し、履歴データをクエリします。データ分析やレポート作成に便利です。

可視化操作

要素に色を設定し、要素を非表示/表示し、特定の要素を選択します。モデルの理解と表示に役立ちます。

構造システムの作成

グリッド、標高、梁・柱システムなどを含む完全な構造フレームシステムを作成します。AIは合理的な構造レイアウトをスマートに生成できます。

コード実行

高度な機能：C#コードを直接Revitに送信して実行し、開発者により大きな柔軟性を提供します。

利点

自然言語対話：複雑なRevit操作画面を学ぶ必要がなく、自然言語で操作できます

効率向上：一括操作とスマートなクエリにより、繰り返し作業が大幅に削減されます

学習コストの削減：専門家でなくても、基本的なモデル操作をすぐに行えます

柔軟な拡張：カスタムコードの実行をサポートし、高度なニーズに対応できます

シームレスな統合：ClaudeやClineなどの主流のAIアシスタントと完全に統合されています

複数バージョン対応：Revit 2020 - 2026の複数バージョンと互換性があります

制限

Revitライセンスが必要：インストールされ、ライセンスが付与されたRevitのコンピューターでのみ使用できます

ネットワーク依存：MCPサーバーは通信にネットワーク接続が必要です

パフォーマンス制限：複雑な操作は手動操作よりも遅くなる場合があり、特に大型モデルで顕著です

機能カバレッジ：一般的な機能はカバーしていますが、すべてのRevitの高度な機能をサポートしているとは限りません

学習曲線：効果的に使用するには、基本的な建築用語と概念を理解する必要があります

使い方

Revitプラグインをダウンロードしてインストールする

GitHub ReleasesページからあなたのRevitバージョンに対応するZIPファイル（mcp - servers - for - revit - v1.0.0 - Revit2025.zipなど）をダウンロードします。解凍後、Revitのプラグインフォルダにコピーします：%AppData%\Autodesk\Revit\Addins\<あなたのRevitバージョン>\

AIクライアントを設定する

Claude Desktopで、設定 → 開発者 → 設定を編集を開き、MCPサーバーの設定を追加します。

Revitを起動する

Autodesk Revitを起動すると、プラグインが自動的に読み込まれます。接続成功のメッセージが表示される場合があります。

AIとの対話を開始する

Claudeチャット画面で、自然言語でRevitで実行したい操作を記述できます。

使用例

迅速なモデル統計

プロジェクトマネージャーは、現在のモデルの複雑さと要素数を迅速に把握し、プロジェクト評価にデータを提供する必要があります。

一括で窓とドアを追加する

建築家は、複数の部屋の同じ位置に標準サイズの窓とドアを追加する必要があります。

材料使用量レポート

コストエンジニアは、プロジェクト内のすべての壁のコンクリート使用量を計算する必要があります。

自動部屋注釈

施工図を作成するために、すべての部屋に名前と面積のラベルを付ける必要があります。

構造グリッドを作成する

構造エンジニアは、規則的な柱グリッドシステムを作成する必要があります。

よくある質問

追加のソフトウェアライセンスを購入する必要がありますか？

このツールは安全ですか？Revitモデルを損傷する可能性はありますか？

どのRevitバージョンをサポートしていますか？

AI操作でエラーが発生した場合はどうすればいいですか？

複数のRevitプロジェクトを同時に接続できますか？

問題を報告したり、新機能を要求するにはどうすればいいですか？

使用するためにプログラミング知識が必要ですか？

大型モデルの処理は遅くなりますか？

🚀 mcp-servers-for-revit

Model Context Protocolを介してAIアシスタントをAutodesk Revitに接続します。

mcp-servers-for-revitは、Claude、ClineなどのAIクライアントやその他のMCP互換ツールが、Revitプロジェクト内の要素を読み取り、作成、変更、削除できるようにします。このプロジェクトは3つのコンポーネントで構成されています。AIにツールを公開するTypeScriptのMCPサーバー、Revit内でコマンドをブリッジするC#のRevitアドイン、そして実際のRevit API操作を実装するコマンドセットです。

⚠️ 重要提示

このプロジェクトは、元のrevit-mcpプロジェクトをフォークし、追加のツールと機能の改善を加えたものです。

🚀 クイックスタート

リリース版を使用する場合

Releasesページから、使用するRevitバージョンに対応したZIPファイルをダウンロードします（例：mcp-servers-for-revit-v1.0.0-Revit2025.zip）。

ZIPファイルを解凍し、内容をRevitのアドインフォルダにコピーします。

%AppData%\Autodesk\Revit\Addins\<Revitのバージョン>\

コピー後、以下のような構成になります。

Addins/2025/
├── mcp-servers-for-revit.addin
└── revit_mcp_plugin/
    ├── revit-mcp-plugin.dll
    ├── ...
    └── Commands/
        └── RevitMCPCommandSet/
            ├── command.json
            └── 2025/
                ├── RevitMCPCommandSet.dll
                └── ...

AIクライアントでMCPサーバーを設定します（後述）。
Revitを起動すると、プラグインが自動的に読み込まれます。

✨ 主な機能

mcp-servers-for-revitは、AIクライアントとRevitを接続し、以下のような操作を可能にします。

AIクライアントからのツール呼び出しをWebSocketメッセージに変換するMCPサーバー。
Revit内で実行され、WebSocketメッセージを受信してコマンドセットに転送するRevitプラグイン。
実際のRevit API操作を実行し、結果を返すコマンドセット。

📦 インストール

MCPサーバーのセットアップ

MCPサーバーはnpmパッケージとして公開されており、npxで直接実行できます。

Claude Code

claude mcp add mcp-server-for-revit -- cmd /c npx -y mcp-server-for-revit

Claude Desktop Claude Desktop → 設定 → 開発者 → 設定の編集 → claude_desktop_config.json：

{
    "mcpServers": {
        "mcp-server-for-revit": {
            "command": "cmd",
            "args": ["/c", "npx", "-y", "mcp-server-for-revit"]
        }
    }
}

Claude Desktopを再起動します。ハンマーアイコンが表示されると、MCPサーバーが接続されます。

Revitプラグインのセットアップ

リリース版のZIPファイルを使用する場合、プラグインはすでに含まれています。手動でインストールする場合は、以下の手順を実行します。

plugin/からプラグインをビルドします（開発を参照）。
mcp-servers-for-revit.addinを%AppData%\Autodesk\Revit\Addins\<バージョン>\にコピーします。
revit_mcp_plugin/フォルダを同じアドインディレクトリにコピーします。

コマンドセットのセットアップ

リリース版のZIPファイルを使用する場合、コマンドセットはプラグイン内に事前にインストールされています。手動でインストールする場合は、以下の手順を実行します。

commandset/からコマンドセットをビルドします（開発を参照）。
プラグインのインストールディレクトリ内にCommands/RevitMCPCommandSet/<年>/を作成します。
ビルドしたDLLをそのフォルダにコピーします。
command.json（リポジトリのルートから）をCommands/RevitMCPCommandSet/にコピーします。

💻 使用例

サポートされているツール

ツール	説明
`get_current_view_info`	現在のアクティブビューの情報を取得します。
`get_current_view_elements`	現在のアクティブビューから要素を取得します。
`get_available_family_types`	現在のプロジェクトで利用可能なファミリータイプを取得します。
`get_selected_elements`	現在選択されている要素を取得します。
`get_material_quantities`	材料の数量と見積もりを計算します。
`ai_element_filter`	AIアシスタント用のインテリジェントな要素クエリツールです。
`analyze_model_statistics`	要素数でモデルの複雑さを分析します。
`create_point_based_element`	点ベースの要素（ドア、窓、家具など）を作成します。
`create_line_based_element`	線ベースの要素（壁、梁、パイプなど）を作成します。
`create_surface_based_element`	面ベースの要素（床、天井、屋根など）を作成します。
`create_grid`	スマートな間隔生成でグリッドシステムを作成します。
`create_level`	指定された標高にレベルを作成します。
`create_room`	指定された場所に部屋を作成して配置します。
`create_dimensions`	現在のビューに寸法注釈を作成します。
`create_structural_framing_system`	構造梁のフレーミングシステムを作成します。
`delete_element`	IDで要素を削除します。
`operate_element`	要素に対して操作を行います（選択、色設定、非表示など）。
`color_elements`	パラメータ値に基づいて要素に色を付けます。
`tag_all_walls`	現在のビュー内のすべての壁にタグを付けます。
`tag_all_rooms`	現在のビュー内のすべての部屋にタグを付けます。
`export_room_data`	プロジェクト内のすべての部屋データをエクスポートします。
`store_project_data`	プロジェクトのメタデータをローカルデータベースに保存します。
`store_room_data`	部屋のメタデータをローカルデータベースに保存します。
`query_stored_data`	保存されたプロジェクトおよび部屋のデータをクエリします。
`send_code_to_revit`	C#コードをRevitに送信して実行します。
`say_hello`	Revit内に挨拶ダイアログを表示します（接続テスト）。

📚 ドキュメント

アーキテクチャ

flowchart LR
    Client["MCP Client<br/>(Claude, Cline, etc.)"]
    Server["MCP Server<br/><code>server/</code>"]
    Plugin["Revit Plugin<br/><code>plugin/</code>"]
    CommandSet["Command Set<br/><code>commandset/</code>"]
    Revit["Revit API"]

    Client <-->|stdio| Server
    Server <-->|WebSocket| Plugin
    Plugin -->|loads| CommandSet
    CommandSet -->|executes| Revit

MCPサーバー（TypeScript）は、AIクライアントからのツール呼び出しをWebSocketメッセージに変換します。Revitプラグイン（C#）はRevit内で実行され、それらのメッセージをリッスンしてコマンドセット（C#）に転送します。コマンドセットは実際のRevit API操作を実行し、結果をチェーンに戻します。

要件

Node.js 18+（MCPサーバー用）
Autodesk Revit 2020 - 2026（サポートされている任意のバージョン）

テスト

テストプロジェクトはNice3point.TUnit.Revitを使用して、実行中のRevitインスタンスに対して統合テストを実行します。別のアドインのインストールは必要ありません。このフレームワークは自動的に実行中のRevitプロセスに注入されます。

前提条件

.NET 10 SDK — Nice3point.Revit.Sdk 6.1.0に必要です。winget install Microsoft.DotNet.SDK.10でインストールします。
Autodesk Revit 2026（または2025） — マシンにインストールされ、ライセンスが必要です。

テストの実行

Revit 2026（または2025）を開き、完全に読み込まれるまで待ちます。
コマンドラインからテストを実行します。

# Revit 2026用
dotnet test -c Debug.R26 -r win-x64 tests/commandset

# Revit 2025用
dotnet test -c Debug.R25 -r win-x64 tests/commandset

注意：-r win-x64フラグは、Revit APIアセンブリがx64のみであるため、ARM64マシンで必要です。

あるいは、dotnet runを使用することもできます。

cd tests/commandset
dotnet run -c Debug.R26

IDEのサポート

JetBrains Rider — 設定 > ビルド、実行、デプロイ > ユニットテスト > テストプラットフォームで「テストプラットフォームのサポート」を有効にします。
Visual Studio — 標準のテストエクスプローラーを通じてテストを検出できます。

テスト構造

ディレクトリ	目的
`tests/commandset/AssemblyInfo.cs`	グローバルな`[assembly: TestExecutor<RevitThreadExecutor>]`の登録
`tests/commandset/Architecture/`	レベルと部屋の作成コマンドのテスト
`tests/commandset/DataExtraction/`	モデル統計、部屋データのエクスポート、および材料数量のテスト
`tests/commandset/ColorSplashTests.cs`	色上書き機能のテスト
`tests/commandset/TagRoomsTests.cs`	部屋のタグ付け機能のテスト

新しいテストの作成

テストクラスはRevitApiTestを継承し、TUnitの非同期アサーションAPIを使用します。

public class MyTests : RevitApiTest
{
    private static Document _doc;

    [Before(HookType.Class)]
    [HookExecutor<RevitThreadExecutor>]
    public static void Setup()
    {
        _doc = Application.NewProjectDocument(UnitSystem.Imperial);
    }

    [After(HookType.Class)]
    [HookExecutor<RevitThreadExecutor>]
    public static void Cleanup()
    {
        _doc?.Close(false);
    }

    [Test]
    public async Task MyTest_Condition_ExpectedResult()
    {
        var elements = new FilteredElementCollector(_doc)
            .WhereElementIsNotElementType()
            .ToElements();

        await Assert.That(elements.Count).IsGreaterThan(0);
    }
}

開発

MCPサーバー

cd server
npm install
npm run build

サーバーはTypeScriptをserver/build/にコンパイルします。開発中はnpx tsx server/src/index.tsで直接実行できます。

Revitプラグイン + コマンドセット

Visual Studioでmcp-servers-for-revit.slnを開きます。このソリューションには、プラグインとコマンドセットのプロジェクトが含まれています。ビルド構成はRevit 2020 - 2026を対象としています。

Revit 2020 - 2024：.NET Framework 4.8（Release R20からRelease R24）
Revit 2025 - 2026：.NET 8（Release R25、Release R26）

ソリューションをビルドすると、plugin/bin/AddIn <年> <構成>/に完全なデプロイ可能なレイアウトが自動的に組み立てられます。コマンドセットはビルドの一部としてプラグインのCommands/フォルダにコピーされます。

プロジェクト構造

mcp-servers-for-revit/
├── mcp-servers-for-revit.sln    # 結合されたソリューション（プラグイン + コマンドセット + テスト）
├── command.json     # コマンドセットのマニフェスト
├── server/          # MCPサーバー（TypeScript） - AIクライアントに公開されるツール
├── plugin/          # Revitアドイン（C#） - Revit内のWebSocketブリッジ
├── commandset/      # コマンドの実装（C#） - Revit API操作
├── tests/           # 統合テスト（C#） - 実行中のRevitに対するTUnitテスト
├── assets/          # ドキュメント用の画像
├── .github/         # CI/CDワークフロー、貢献ガイド、行動規範
├── LICENSE
└── README.md