Revit Mcp

🔴

警告

弃用通知：此仓库将归档，改用适用于 MCP 的单仓库方案 https://github.com/mcp-servers-for-revit/mcp-servers-for-revit CI 更简单，新手更不容易困惑，提供 npm 软件包，安装也更简单

---

---

revit-mcp

English | 简体中文

描述

revit-mcp 允许你通过支持 MCP 的客户端（例如 Claude、Cline 等），使用 MCP 协议与 Revit 交互。

此项目是服务端（向 AI 提供工具），你需要配合使用 revit-mcp-plugin（驱动 Revit）。

加入 Discord | QQ Group

功能

• 允许 AI 从 Revit 项目中获取数据
• 允许 AI 驱动 Revit 创建、修改和删除元素
• 将 AI 生成的代码发送到 Revit 执行（不一定能成功；在某些需求明确的简单场景中，成功率较高）

要求

• nodejs 18+

完整的安装环境还需考虑 revit-mcp-plugin 的要求，请参阅 revit-mcp-plugin

安装

1. 构建本地 MCP 服务

安装依赖

npm install

构建

npm run build

2. 客户端配置

Claude 客户端

Claude 客户端 -> Settings > Developer > Edit Config > claude_desktop_config.json

{
    "mcpServers": {
        "revit-mcp": {
            "command": "node",
            "args": ["<path to the built file>\\build\\index.js"]
        }
    }
}

重启 Claude 客户端。看到锤子图标时，表示与 MCP 服务的连接正常。

框架

flowchart LR
	ClaudeDesktop --> revit-mcp --> SocketService--commandName-->CommandSet--command-->CommandExecute
	CommandManager --> CommandSet
	CommandExecute --executeResult--> SocketService
	CommandProject1 --> CommandManager
	CommandProject2 --> CommandManager
	CommandProject... --> CommandManager
	subgraph ide1 [MCPClient]
	ClaudeDesktop
	end
	subgraph ide2 [MCPServer]
	revit-mcp
	end
	subgraph ide3 [Revit]
			subgraph ide3.1 [revit-mcp-plugin]
				SocketService
				CommandSet
				CommandManager
				CommandExecute
			end
	end

支持的工具

名称	描述
get_current_view_info	获取当前活动视图信息
get_current_view_elements	获取当前活动视图中的元素
get_available_family_types	获取当前项目中可用的族类型
get_selected_elements	获取当前选中的元素
get_material_quantities	计算材料数量并生成工程量清单
ai_element_filter	面向 AI 助手的智能元素查询工具
analyze_model_statistics	统计元素数量，分析模型复杂度
create_point_based_element	创建基于点的元素（门、窗、家具）
create_line_based_element	创建基于线的元素（墙、梁、管道）
create_surface_based_element	创建基于面的元素（楼板、天花板、屋顶）
create_grid	创建具有智能间距生成的网格系统
create_level	在指定标高处创建楼层
create_room	在指定位置创建并放置房间
create_structural_framing_system	创建结构梁架系统
delete_element	按 ID 删除元素
operate_element	操作元素（选择、设置颜色、隐藏等）
color_elements	根据参数值为元素着色
tag_all_walls	为当前视图中的所有墙添加标记
tag_all_rooms	为当前视图中的所有房间添加标记
export_room_data	导出项目中的所有房间数据
store_project_data	将项目元数据存储到本地数据库
store_room_data	将房间元数据存储到本地数据库
query_stored_data	查询已存储的项目和房间数据
send_code_to_revit	将 C# 代码发送到 Revit 执行
say_hello	在 Revit 中显示问候对话框（连接测试）