xml.Revit.MCP 工具概述

英文 | 中文文档

xml.Revit.MCP 提供了一整套工具，用于通过模型上下文协议（MCP）与Autodesk Revit集成。此库作为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以包含：

Cursor

编辑mcp.json以包含：

Cline

编辑cline_mcp_setting.json以包含：

{
  "mcpServers": {
    "RevitMCPServer": {
      "disabled": false,
      "timeout": 30,
      "command": "uvx",
      "args": ["revit-mcp"],
      "transportType": "stdio",
      "autoApprove": [
        "active_view",
        "call_func",
        "create_cable_trays",
        "create_door_windows",
        "create_ducts",
        "create_family_instances",
        "create_floors",
        "create_floor_plan_views",
        "create_grids",
        "create_levels",
        "create_pipes",
        "create_room_separation_lines",
        "create_room_tags",
        "create_rooms",
        "create_sheets",
        "create_walls",
        "delete_elements",
        "execute_commands",
        "find_elements",
        "get_commands",
        "get_locations",
        "get_selected_elements",
        "get_view_data",
        "link_dwg_and_activate_view",
        "move_elements",
        "parameter_elements",
        "show_elements",
        "update_elements"
      ]
    }
  }
}

扩展功能

你可以创建自定义的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工具库提供的各种命令。