RevitMCPServer

xml.Revit.MCP ツールの概要

英語 | 中国語ドキュメント

xml.Revit.MCP は、Model Context Protocol（MCP）を通じて Autodesk Revit と連携するための包括的なツールセットを提供します。このライブラリは AI アシスタントと Revit の橋渡し役となり、強力な自動化機能と建築モデルとのプログラムによる対話を実現します。

主な機能

このツールライブラリには、Revit の自動化と対話のための多数の機能が含まれています。

基本操作：

• Revit プラグインで利用可能なコマンドを取得
• Revit で指定したコマンドを実行
• パラメーターを指定して特定の Revit 関数を呼び出す
• ビューのデータと選択した要素を取得

要素の管理：

• カテゴリ別に要素を検索
• 要素のパラメーターと位置を取得
• 要素のパラメーターを更新
• 要素を削除
• 現在のビューに要素を表示／ハイライト
• 要素を新しい位置に移動

作成ツール：

• レベル／床を作成
• 平面図ビューを作成
• グリッド線を作成
• 壁と床を作成
• 部屋と部屋タグを作成
• ドアと窓を作成
• MEP 要素（ダクト、配管、ケーブルトレイ）を作成
• ファミリインスタンスを作成
• DWG ファイルをリンク
• シートを作成

インストール要件

• xml.Revit：バージョン 1.3.4.3 以降
• Python：3.10 以降
• UV パッケージマネージャー：インストールに必要
• Revit：バージョン 2019～2024 に対応（プラグインが必要）

インストール手順

1. まず、UV パッケージマネージャーをインストールします。

   pip install uv
   

2. revit-mcp パッケージをインストールします。

   pip install revit-mcp
   

3. インストールをテストします。

   uvx revit-mcp
   

   次のメッセージが表示されます：RevitMCPServer - INFO - Successfully connected to Revit on startup

AI アシスタントとの連携

Claude for Desktop

claude_desktop_config.json を編集して、以下を追加します。

Cursor

mcp.json を編集して、以下を追加します。

Cline

cline_mcp_setting.json を編集して、以下を追加します。

{
  "mcpServers": {
    "RevitMCPServer": {
      "disabled": false,
      "timeout": 30,
      "command": "uvx",
      "args": ["revit-mcp"],
      "transportType": "stdio",
      "autoApprove": [
        "active_view",
        "call_func",
        "create_cable_trays",
        "create_door_windows",
        "create_ducts",
        "create_family_instances",
        "create_floors",
        "create_floor_plan_views",
        "create_grids",
        "create_levels",
        "create_pipes",
        "create_room_separation_lines",
        "create_room_tags",
        "create_rooms",
        "create_sheets",
        "create_walls",
        "delete_elements",
        "execute_commands",
        "find_elements",
        "get_commands",
        "get_locations",
        "get_selected_elements",
        "get_view_data",
        "link_dwg_and_activate_view",
        "move_elements",
        "parameter_elements",
        "show_elements",
        "update_elements"
      ]
    }
  }
}

機能の拡張

以下の手順でカスタム MCP DLL ファイルを作成し、機能を追加できます。

1. xml.Revit.MCP.Public.IMCPMethod インターフェースを実装します
2. 通信には JSON-RPC 2.0 仕様に従います
3. DLL にコンパイルし、指定された MCP フォルダーに配置します

プラグインの設定

revit-mcp-plugin を使用する場合：

1. Revit にプラグインを登録します
2. 「アドインモジュール」→「Revit MCP Plugin」→「設定」からコマンドを設定します
3. 「アドイン」→「Revit MCP Plugin」→「Revit MCP Switch」からサービスを有効にします

有効にすると、AI アシスタントは Revit プログラムを検出して制御し、xml.Revit.MCP ツールライブラリが提供するさまざまなコマンドを実行できるようになります。