Revit MCP

🚀 xml.Revit.MCP 工具概述

xml.Revit.MCP 提供了一套全面的工具集，用於通過模型上下文協議（Model Context Protocol, MCP）與 Autodesk Revit 進行集成。此庫充當 AI 助手和 Revit 之間的橋樑，可實現強大的自動化功能，並支持對建築模型進行編程交互。

🚀 快速開始

xml.Revit.MCP 作為 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 - 成功連接到 Revit

📚 詳細文檔

與 AI 助手集成

Claude for Desktop

編輯 claude_desktop_config.json 文件，添加以下內容：

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Cursor

編輯 mcp.json 文件，添加以下內容：

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Cline

編輯 cline_mcp_setting.json 文件，添加以下內容：

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

擴展功能

你可以通過創建自定義 MCP DLL 文件來實現更多功能：

1. 實現 xml.Revit.MCP.Public.IMCPMethod 接口
2. 遵循 JSON - RPC 2.0 規範進行通信
3. 編譯為 DLL 文件並放置在指定的 MCP 文件夾中

插件配置

使用 revit - mcp - plugin 時：

1. 在 Revit 中註冊插件
2. 通過：添加項 → Revit MCP 插件 → 設置 進行命令配置
3. 啟用服務：添加項 → Revit MCP 插件 → Revit MCP 開關

啟用後，AI 助手可以發現並控制你的 Revit 程序，執行 xml.Revit.MCP 工具庫提供的各種命令。