MCP Servers For Revit

🚀 Revit模型上下文協議服務器

通過模型上下文協議（MCP）將AI助手連接到Autodesk Revit。

mcp-servers-for-revit使Claude、Cline等AI客戶端以及其他支持MCP的工具能夠讀取、創建、修改和刪除Revit項目中的元素。它由三個組件組成：一個將工具暴露給AI的TypeScript MCP服務器、一個將命令橋接到Revit的C# Revit插件，以及一組實現實際Revit API操作的命令集。

⚠️ 重要提示

本項目是原 revit-mcp 項目的分支，增加了額外的工具並改進了功能。

🚀 快速開始

使用發佈版本

1. 從 發佈頁面 下載適合你Revit版本的ZIP文件（例如，mcp-servers-for-revit-v1.0.0-Revit2025.zip）。
2. 解壓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
                   └── ...
   

3. 在你的AI客戶端中配置MCP服務器（見下文）。
4. 啟動Revit - 插件將自動加載。

MCP服務器設置

MCP服務器作為npm包發佈，可以直接使用 npx 運行。

Claude代碼

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

Claude桌面版 Claude桌面版 → 設置 → 開發者 → 編輯配置 → claude_desktop_config.json：

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

重啟Claude桌面版。當你看到錘子圖標時，MCP服務器已連接。

Revit插件設置

如果使用發佈的ZIP文件，插件已經包含在內。如需手動安裝：

1. 從 plugin/ 目錄構建插件（見 開發）。
2. 將 mcp-servers-for-revit.addin 複製到 %AppData%\Autodesk\Revit\Addins\<版本>\。
3. 將 revit_mcp_plugin/ 文件夾複製到同一個插件目錄。

命令集設置

如果使用發佈的ZIP文件，命令集已預先安裝在插件中。如需手動安裝：

1. 從 commandset/ 目錄構建命令集（見 開發）。
2. 在插件的安裝目錄中創建 Commands/RevitMCPCommandSet/<年份>/。
3. 將構建好的DLL文件複製到該文件夾。
4. 將 command.json（從倉庫根目錄）複製到 Commands/RevitMCPCommandSet/。

✨ 主要特性

• 多工具支持：支持Claude、Cline等多種AI客戶端以及其他MCP兼容工具。
• 豐富的操作功能：可以對Revit項目中的元素進行讀取、創建、修改和刪除等操作。
• 模塊化設計：由MCP服務器、Revit插件和命令集三個組件組成，結構清晰。

📦 安裝指南

環境要求

• Node.js 18+（用於MCP服務器）
• Autodesk Revit 2020 - 2026（任何受支持的版本）

安裝步驟

按照上述 快速開始 中的步驟進行安裝。

💻 使用示例

基礎用法

# 在Claude中添加MCP服務器
claude mcp add mcp-server-for-revit -- cmd /c npx -y mcp-server-for-revit

高級用法

// 在Claude桌面版中配置MCP服務器
{
    "mcpServers": {
        "mcp-server-for-revit": {
            "command": "cmd",
            "args": ["/c", "npx", "-y", "mcp-server-for-revit"]
        }
    }
}

📚 詳細文檔

支持的工具

測試

測試項目使用 Nice3point.TUnit.Revit 對即時Revit實例運行集成測試。無需單獨安裝插件 — 框架會自動注入正在運行的Revit進程。

前提條件

• .NET 10 SDK — Nice3point.Revit.Sdk 6.1.0 需要此SDK。通過 winget install Microsoft.DotNet.SDK.10 進行安裝。
• Autodesk Revit 2026（或2025） — 必須安裝並在你的機器上獲得許可。

運行測試

1. 打開Revit 2026（或2025）並等待其完全加載。
2. 從命令行運行測試：

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

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

注意：在ARM64機器上，-r win-x64 標誌是必需的，因為Revit API程序集僅支持x64。

或者，你可以使用 dotnet run：

cd tests/commandset
dotnet run -c Debug.R26

IDE支持

• JetBrains Rider — 在設置 > 構建、執行、部署 > 單元測試 > 測試平臺中啟用“測試平臺支持”。
• Visual Studio — 測試應該可以通過標準的測試資源管理器發現。

測試結構

編寫新測試

測試類繼承自 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);
    }
}

🔧 技術細節

架構

flowchart LR
    Client["MCP客戶端<br/>(Claude, Cline等)"]
    Server["MCP服務器<br/><code>server/</code>"]
    Plugin["Revit插件<br/><code>plugin/</code>"]
    CommandSet["命令集<br/><code>commandset/</code>"]
    Revit["Revit API"]

    Client <-->|標準輸入輸出| Server
    Server <-->|WebSocket| Plugin
    Plugin -->|加載| CommandSet
    CommandSet -->|執行| Revit

MCP服務器（TypeScript）將AI客戶端的工具調用轉換為WebSocket消息。Revit插件（C#）在Revit內部運行，監聽這些消息，並將它們分發給命令集（C#），命令集執行實際的Revit API操作並將結果返回。

開發

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

發佈

單個 v* 標籤驅動整個發佈過程。發佈工作流 會自動執行以下操作：

• 為Revit 2020 - 2026構建Revit插件和命令集。
• 創建一個GitHub發佈，包含 mcp-servers-for-revit-vX.Y.Z-Revit<年份>.zip 資產。
• 將MCP服務器發佈到npm，包名為 mcp-server-for-revit。

要創建發佈：

1. 運行版本更新腳本（更新 server/package.json、server/package-lock.json 和 plugin/Properties/AssemblyInfo.cs，然後提交併打標籤）：

   ./scripts/release.ps1 -Version X.Y.Z
   

2. 推送以觸發工作流：

   git push origin main --tags
   

⚠️ 重要提示

npm發佈使用 可信發佈 通過OIDC進行 — 無需npm令牌。出處證明會自動生成。

📄 許可證

MIT

致謝

本項目是 mcp-servers-for-revit 團隊工作的分支。原始倉庫如下：

• revit-mcp - MCP服務器
• revit-mcp-plugin - Revit插件
• revit-mcp-commandset - 命令集

感謝原始作者創建了本項目的基礎。