Autodesk Revit MCP服务器
Autodesk Revit的模型上下文协议服务器
   
______________________________________________________________________
概述
生产就绪的MCP服务器，使AI代理能够通过自然语言控制Autodesk Revit。与Claude Desktop、Microsoft Copilot和自定义MCP客户端集成。
主要特点：
- 100+Revit API工具（几何图形、视图、图纸、族、MEP、结构）
- 响应时间低于秒的本地主机HTTP网桥
- 线程安全外部事件架构
- 高级反射API，用于无限制的Revit访问
- 生产就绪，工具覆盖全面
快速开始
先决条件
- Windows 10/11
- Autodesk Revit 2024-2026
- Python 3.11+
- .NET Framework 4.8
安装
# Clone repository
git clone https://github.com/Sam-AEC/Autodesk-Revit-MCP-Server.git
cd Autodesk-Revit-MCP-Server
# Build Revit add-in
.\scripts\build-addin.ps1 -RevitVersion 2024
# Install Python package
pip install -e packages/mcp-server-revit配置Claude桌面
编辑 %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"revit": {
"command": "python",
"args": ["-m", "revit_mcp_server.mcp_server"],
"env": {
"MCP_REVIT_BRIDGE_URL": "http://127.0.0.1:3000",
"MCP_REVIT_MODE": "bridge"
}
}
}
}配置VS代码/GitHub副本
此存储库包括一个工作区MCP配置，位于 .vscode/mcp.json安装Python包并启动Revit并加载桥加载项后，在VS Code中打开此存储库并运行 MCP: List Servers 或使用MCP服务器视图。
有关市场和注册表发布的详细信息，请参阅 MCP市场和客户分布.
验证安装
启动Revit，然后：
curl http://localhost:3000/health预期响应：
{
"status": "healthy",
"revit_version": "2024"
}______________________________________________________________________
建筑
┌─────────────────────────────────┐
│ AI Client (Claude/Copilot) │
└───────────────┬─────────────────┘
│ MCP Protocol
┌───────────────▼─────────────────┐
│ MCP Server (Python) │
│ - Tool Registry │
│ - Security/Audit │
└───────────────┬─────────────────┘
│ HTTP :3000
┌───────────────▼─────────────────┐
│ Revit Bridge Add-in (C#) │
│ - HTTP Server │
│ - ExternalEvent Handler │
└───────────────┬─────────────────┘
│ Revit API
┌───────────────▼─────────────────┐
│ Autodesk Revit 2024-2026 │
└─────────────────────────────────┘螺纹型号： HTTP请求通过以下方式排队并在Revit的主线程上执行 ExternalEvent 为了螺纹安全。
桥梁状态： 该网桥在端口3000上作为localhost HTTP服务器运行，提供健康检查和工具执行端点。
______________________________________________________________________
可用工具
文档管理
revit.create_new_document-创建空白项目revit.open_document-打开RVT/RFA文件revit.save_document-保存活动文档revit.close_document-关闭文档revit.get_document_info-获取项目元数据
标高和网格
revit.create_level-在标高处创建标高revit.list_levels-列出所有级别revit.create_grid-创建网格线
模型元素
revit.create_wall-从曲线创建墙revit.create_floor-从轮廓创建地板revit.create_roof-根据轮廓创建屋顶revit.create_column-创建结构柱revit.create_beam-创建结构梁revit.create_foundation-创建基础元素revit.create_room-创建房间边界
MEP系统
revit.create_duct-创建暖通空调风管revit.create_pipe-创建卫浴管道revit.create_cable_tray-创建电缆桥架revit.create_conduit-创建电气导管revit.get_mep_systems-列出MEP系统
系列和组件
revit.place_family_instance-放置家庭实例revit.place_door-将门放在墙上revit.place_window-把窗户放在墙上revit.list_families-列出加载的族revit.edit_family-编辑家庭文档
元素操作
revit.delete_element-删除元素revit.copy_element-复制带有翻译的元素revit.move_element-按向量移动元素revit.rotate_element-围绕轴旋转元素revit.mirror_element-平面上的镜像元素revit.pin_element-销钉元件就位revit.unpin_element-Unpin元件
参数
revit.get_element_parameters-读取元素参数revit.set_parameter_value-写入参数值revit.get_parameter_value-读取单个参数revit.batch_set_parameters-批量更新参数revit.get_type_parameters-获取类型参数revit.set_type_parameter-设置类型参数
视图
revit.create_3d_view-创建等轴测三维视图revit.create_section_view-创建剖面视图revit.create_floor_plan_view-创建平面布置图revit.duplicate_view-重复视图revit.apply_view_template-应用视图样板revit.get_view_templates-列表视图模板revit.list_views-列出所有视图
表格和文件
revit.create_sheet-创建带有标题栏的图纸revit.place_viewport_on_sheet-将视口放置在图纸上revit.list_sheets-列出所有工作表revit.delete_sheet-删除工作表revit.duplicate_sheet-重复工作表revit.get_sheet_info-获取工作表信息revit.list_titleblocks-列出标题栏类型revit.populate_titleblock-填写标题栏参数revit.renumber_sheets-重新编号纸张revit.batch_create_sheets_from_csv-从CSV创建工作表
标注
revit.create_tag-创建元素标签revit.create_dimension-创建维度revit.create_text_note-创建文本注释revit.create_text_type-创建文本类型revit.tag_all_in_view-标记视图中的所有元素revit.create_revision_cloud-创建修订云
选择和查询
revit.get_selection-获取当前选择revit.set_selection-设置元素选择revit.list_elements_by_category-按类别查询revit.get_element_type-获取元素类型revit.get_element_bounding_box-获取元素边界revit.get_categories-列出所有类别
群组和链接
revit.create_group-创建模型组revit.ungroup-取消元素分组revit.convert_to_group-转换为组revit.get_group_members-获取组成员revit.get_link_instances-列出链接实例revit.get_rvt_links-列出Revit链接
时间表和数据
revit.create_schedule-创建明细表视图revit.get_schedule_data-提取日程数据revit.export_schedules-将计划导出到CSVrevit.calculate_material_quantities-计算数量
出口业务
revit.export_pdf_by_sheet_set-导出为PDFrevit.export_dwg_by_view-导出为DWGrevit.export_ifc_with_settings-出口至IFCrevit.export_navisworks-导出到Navisworksrevit.export_image-将视图导出为图像revit.render_3d_view-渲染三维视图
项目信息
revit.get_phases-列出项目阶段revit.get_phase_filters-列出相位滤波器revit.get_design_options-列出设计选项revit.get_worksets-列出工作集revit.get_warnings-获取型号警告revit.get_project_location-获取项目位置
工作共享
revit.sync_to_central-与中心同步revit.relinquish_all-放弃所有元素
材质和渲染
revit.create_material-创建材质revit.set_element_material-指定材料revit.get_render_settings-获取渲染设置
分析与验证
revit.check_clashes-运行碰撞检测revit.get_room_boundary-获取房间边界
高级功能
revit.invoke_method-通用Revit API方法调用revit.reflect_get-通过反射获得财产revit.reflect_set-通过反射设置属性
项目参数
revit.list_shared_parameters-列出共享参数revit.create_shared_parameter-创建共享参数revit.list_project_parameters-列出项目参数revit.create_project_parameter-创建项目参数
修订
revit.get_revision_sequences-获取修订顺序
总计：100+工具 • API完整参考： docs/tools.md
开发状态
该服务器得到了积极维护和持续改进。有关最新更新和已知限制，请参阅：
______________________________________________________________________
安全
违约： 仅限本地主机(127.0.0.1:3000)，不需要身份验证。
企业： 可选HTTPS、OAuth2（Entra ID）、审计日志记录和速率限制。
看 docs/security.md 了解详情。
______________________________________________________________________
项目结构
Autodesk-Revit-MCP-Server/
├── packages/
│ ├── revit-bridge-addin/ # C# Revit Add-in
│ │ └── src/Bridge/
│ │ ├── App.cs # IExternalApplication
│ │ ├── BridgeServer.cs # HTTP server
│ │ └── BridgeCommandFactory.cs
│ └── mcp-server-revit/ # Python MCP Server
│ ├── src/revit_mcp_server/
│ │ ├── mcp_server.py # MCP protocol
│ │ ├── bridge/client.py # HTTP client
│ │ └── tools/ # Tool handlers
│ └── tests/
├── scripts/
│ ├── build-addin.ps1 # Build C# DLL
│ └── install.ps1 # Deploy to Revit
├── docs/
│ ├── tools.md # API reference
│ ├── architecture.md # System design
│ └── security.md # Security model
└── README.md______________________________________________________________________
文档
______________________________________________________________________
许可证
MIT许可证 -版权所有（c）2025
______________________________________________________________________
链接
______________________________________________________________________