Revitmcp

🚀 Revit MCP 集成

本項目是一個適用於 Autodesk Revit 2024.3 的 Model Context Protocol (MCP) 集成方案，它能讓 AI 助手（如 Claude）通過自然語言直接與 Revit 模型進行交互，極大地提升了模型操作的便捷性和效率。

🚀 快速開始

此集成允許大型語言模型 (LLMs) 藉助標準化接口，在 Revit 模型中進行信息查詢、元素創建與修改以及執行復雜操作。具體操作步驟如下：

1. 打開 Revit 和您的模型。
2. 轉到 Revit 跑道中的 "RevitMCP" 標籤。
3. 點擊 "啟動 MCP 服務器" 以啟動 MCP 服務器。
4. 打開 Claude Desktop 或其他兼容的 MCP 客戶端。
5. 配置 MCP 客戶端以連接到服務器。
6. 開始詢問有關 Revit 模型的問題或下達命令！

✨ 主要特性

• 資源：具備通過 MCP 協議與 Revit 模型進行交互的能力。
• 工具：提供創建、修改和查詢 Revit 元素的接口。

📦 安裝指南

先決條件

• Autodesk Revit 2024.3 或更高版本。
• Python 3.13（必須安裝並在 PATH 中可用）。
• 最新版本的 PyRevit。
• MCP Python SDK (pip install mcp[cli])。

安裝步驟

1. 從 python.org 下載並安裝 Python 3.13。
2. 安裝所需的 Python 包：

   pip install mcp[cli] httpx
   

3. 安裝 Revit 2024 的最新版本 PyRevit。
4. 將 RevitMCP.extension 文件夾複製到您的 PyRevit 擴展文件夾中，通常位於：%APPDATA%\pyRevit\extensions。
5. 從 Revit 跑道重新加載 PyRevit。

💻 使用示例

基礎用法

如果沒有 Claude Desktop 或其他 MCP 工具，您可以使用內置的測試界面：

1. 打開 Revit 和您的模型。
2. 轉到 Revit 跑道中的 "RevitMCP" 標籤。
3. 點擊 "打開測試界面" 以啟動 MCP 服務器。
4. 在界面中選擇要發送的問題或命令。
5. 點擊 "發送查詢" 按鈕。

高級用法

以下是您可以發送給 Claude 的一些示例查詢：

• "生成一個帶有 3 個臥室和 2 個浴室的新樓層平面圖。"
• "在當前項目中添加一座新的兩層結構。"
• "刪除所有未使用的 Revit 元素並清理模型。"

🔧 技術細節

此集成實現使用了由 Anthropic 開發的開放標準 Model Context Protocol (MCP)，該協議定義了 AI 模型如何連接到外部工具和數據源。

📚 詳細文檔

配置 Claude Desktop 連接

1. 打開 Claude Desktop 並轉到設置。
2. 添加新的 API 配置，指定類型為 Revit - MCP。
3. 填寫以下詳細信息：
   • 服務器 URL：http://localhost:8080
   • 接口密鑰：your_api_key_here

故障排除

• Python 錯誤：運行 pip install mcp[cli] httpx 以安裝所需的包。
• Revit 錯誤：確保使用與 Revit 2024 兼容的最新 PyRevit 版本。

📄 許可證

此項目在 MIT License 下發布。

致謝

• Anthropic 開發了 Model Context Protocol。
• PyRevit 團隊開發了出色的 Revit API 包裝器。