🚀 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（需插件）
安装流程
-
首先安装 UV 包管理器：
pip install uv -
安装 revit - mcp 包：
pip install revit-mcp -
测试安装：
uvx revit-mcp你应该看到：
RevitMCPServer - INFO - Successfully connected to Revit on startup
💻 使用示例
集成到 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 文件来实现更多功能：
- 实现
xml.Revit.MCP.Public.IMCPMethod接口 - 遵循 JSON - RPC 2.0 规范进行通信
- 编译为 DLL 并放置在指定的 MCP 文件夹中
插件配置
使用 revit - mcp - plugin 时：
- 在 Revit 中注册插件
- 通过：添加项 → Revit MCP 插件 → 设置 进行命令配置
- 启用服务：添加项 → Revit MCP 插件 → Revit MCP 开关
启用后，AI 助手可以发现并控制你的 Revit 程序，并执行相应操作。