安裝到你的 Revit，完成第一次查詢

先確認這些

新機器走這條

新手建議使用 scripts/setup.ps1。腳本會檢查環境、安裝相依套件、編譯 MCP Server、編譯並部署 Revit Add-in，並協助設定常見 AI Client。

1. 下載 repo

   git clone https://github.com/shuotao/REVIT_MCP_study.git

   下載完成後進入專案資料夾：cd REVIT_MCP_study。後面的指令都從這個 repo 根目錄執行。

   專案頁：github.com/shuotao/REVIT_MCP_study。

2. 在 PowerShell 執行安裝腳本

   在 repo 根目錄（上一步的 REVIT_MCP_study 資料夾）執行 .\scripts\setup.ps1。AI Agent 或非互動模式可用 powershell -ExecutionPolicy Bypass -File scripts/setup.ps1 -NonInteractive -RevitVersions "2024,2025"。

3. 依提示選擇 Revit 版本

   每個版本輸出 MCP/bin/Release.R{YY}/RevitMCP.dll（組態對照見下方 Build Matrix）。

4. 選擇要設定哪些 AI Client

   腳本會協助設定常見 AI Client；各 Client 的設定位置見AI Client 設定。

5. 重啟 AI Client 與 Revit

   啟動或重啟 AI Client，讓它載入 MCP Server；Revit 重新啟動後才會載入新部署的 Add-in。

貼指令出現「'&&' 語彙基元不是有效的陳述式分隔符號」的錯誤？看docs/troubleshoot-first-install.md。

Skill 的安裝已移到貢獻頁

透過 Plugin Marketplace 安裝可分享的 Skill（例如 hj-pr-proposal），是貢獻流程的一部分，與本頁的 Revit 安裝無關。

步驟與封包內容請看：貢獻模板 · 一鍵安裝提案 Skill。

手動 build / deploy（4 步）

1. 關閉 Revit

   新 DLL 才能取代舊 DLL。沒關閉 → DLL is locked → 複製失敗。
   tasklist | findstr Revit 確認。

2. Build

   # 在 repo 根目錄開始執行
   cd MCP-Server
   npm install
   npm run build
   
   cd ..\MCP
   dotnet build -c Release.R24 RevitMCP.csproj

   前三行編譯 MCP Server（AI Client 會啟動 node MCP-Server/build/index.js）；最後一行編譯 Add-in（此時工作目錄是 MCP/），把 R24 換成你要的版本（R22/R23/R24/R25/R26）。輸出在 MCP/bin/Release.R24/RevitMCP.dll。

3. 部署 Add-in

   # 先回到 repo 根目錄（上一步結束時在 MCP/）
   cd ..
   
   # 指定 Revit 版本
   .\scripts\install-addon.ps1 -Version 2024
   
   # 多版本環境一次部署完
   .\scripts\install-addon.ps1 -All

   腳本會複製建構產物中的全部 DLL（R22–R24 為 13 個、R25–R26 為 8 個，兩者都正確）、部署前檢查建構產物世代是否與目標 Revit 相符、部署後逐檔 SHA256 驗證，並輪替舊版備份。偵測到多版本而未指定時，互動模式會要求你選擇，非互動模式則直接失敗，不會擅自挑選。

4. 重啟 Revit，啟動 MCP 服務

   啟動 Revit → 載入或建立專案 → 在 ribbon 的 MCP Tools 面板啟動 MCP 服務 → 確認 Revit 顯示 WebSocket server 已監聽 localhost:8964。之後到第一次查詢驗收。

Build Matrix · 5 個版本

所有 AI Client 指向同一個 MCP Server

核心概念相同：使用 node 啟動 MCP-Server/build/index.js。第一次使用前必須在 MCP-Server/ 跑 npm run build。專案內建的 Claude Code / Codex 風格 .mcp.json 如下：

{
  "mcpServers": {
    "revit-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["./MCP-Server/build/index.js"],
      "env": {}
    }
  }
}

範本中的 <YOUR_PROJECT_PATH> 需替換為本專案的實際路徑。同一時間只有一個 AI Client 能保持連線（獨占鎖，第二個會被 HTTP 409 拒絕）；要換 Client，先在 Revit ribbon 點「切換/釋放連線」。

第一次查詢：只讀，不改模型