Revit MCP

🚀 🏗️ Revit MCP 服務器

一款基於 TypeScript 的模型上下文協議（Model Context Protocol）服務器，它能實現 Claude AI 與 Autodesk Revit 之間的無縫集成，可直接通過 WebSocket 連接訪問 Revit 模型。

English | 中文

🚀 快速開始

此 TypeScript 基礎的 MCP 服務器充當 Claude AI 和 Revit 之間的橋樑，允許通過 WebSocket 連接即時訪問 Revit 模型信息。藉助它，你可以即時獲取 Revit 模型信息、進行元素查詢與篩選、管理視圖和樓層，還具備健壯的錯誤處理及 mock 數據回退機制。

✨ 主要特性

🔌 Revit 集成

• 📡 通過 WebSocket 實現 Revit 插件通信
• 🔄 即時模型數據訪問
• 🔁 連接失敗時自動回退到 mock 數據
• ⚙️ 通過環境變量配置連接設置

🚀 核心功能

• 📊 模型信息

  • 獲取基本模型元數據（名稱、路徑、版本）
  • 獲取元素數量和最後修改日期
  • 即時同步模型狀態

• 🏗️ 元素管理

  • 使用靈活過濾器查詢元素
  • 訪問元素屬性和幾何形狀
  • 批量操作元素

• 🎪 視圖與樓層控制

  • 列出所有可用視圖
  • 獲取樓層信息
  • 遍歷模型層次結構

📦 安裝指南

📋 先決條件

• Node.js (v14 或更高版本)
• npm
• Autodesk Revit (2023 或更高版本)
• Revit WebSocket 插件（配套插件）

🔧 安裝

安裝依賴：

npm install

構建服務器：

npm run build

開發時自動重建：

npm run watch

⚙️ 配置

服務器可通過環境變量進行配置：

REVIT_HOST=127.0.0.1    # Revit 插件 WebSocket 服務端地址
REVIT_PORT=8080         # Revit 插件 WebSocket 端口

💻 使用示例

🔗 與 Claude Desktop 集成

將服務器配置添加到 Claude Desktop： Windows:

%APPDATA%/Claude/claude_desktop_config.json

配置格式：

{
  "mcpServers": {
    "revit-mcp-server": {
      "command": "D:/path/to/revit-mcp-server/build/index.js"
    }
  }
}

🐛 調試

調試 MCP 通信：

1. 使用內置的 MCP 檢查工具：

npm run inspector

2. 監控與 Revit 插件之間的 WebSocket 通信
3. 查看服務器日誌獲取連接和操作狀態信息

⚠️ 重要提示

⚠️ 重要提示

服務器實現了健壯的錯誤處理機制，連接 Revit 失敗時會自動回退到 mock 數據，同時會有詳細的錯誤記錄以及平滑的連接恢復。

📄 許可證

本項目採用 MIT License 許可協議。

🤝 貢獻

歡迎大家為項目貢獻代碼！請隨意提交拉取請求。

📬 聯繫方式

如有任何問題或建議，請隨時通過以下方式聯繫我們：

• 📧 電子郵箱：353554036@qq.com
• 💬 微信賬號：modian4500