🏗️ Revit MCP Server

🏗️ Revit MCP Server

site icon
2025.04.15 4
TypeScript建筑信息模型AI 集成开发效率
Revit MCP Server 是一个基于 TypeScript 的模型上下文协议服务器,旨在为 Claude AI 和 Autodesk Revit 之间提供无缝通信桥梁。它通过 WebSocket 连接实现与 Revit 模型的直接交互,提供实时模型数据访问、元素查询与过滤、视图和层级管理等功能。
View on GitHub

Overview

基本能力

产品定位

Revit MCP Server 是一个专为 Autodesk Revit 设计的模型上下文协议服务器,用于实现 Claude AI 与 Revit 之间的高效通信和数据交互。

核心功能

  1. Revit 集成
  2. 基于 WebSocket 的通信机制
  3. 实时模型数据访问
  4. 连接失败时的模拟数据回退
  5. 通过环境变量配置连接设置

  6. 核心功能

  7. 模型信息:访问模型元数据、元素计数、最后修改日期等
  8. 元素管理:查询元素、访问元素属性和几何形状、批量操作元素
  9. 视图与层级控制:列出可用视图、访问层级信息、模型层次导航

适用场景

  • 建筑信息模型(BIM)的自动化处理
  • Revit 模型的实时数据访问和操作
  • AI 辅助的建筑设计和分析

使用教程

使用依赖

  • Node.js (v14 或更高版本)
  • npm
  • Autodesk Revit (2023 或更高版本)
  • Revit WebSocket 插件(配套插件)

安装教程

  1. 安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 开发模式下自动重建:
npm run watch

配置

通过环境变量配置服务器:

REVIT_HOST=127.0.0.1    # Revit 插件 WebSocket 主机
REVIT_PORT=8080         # Revit 插件 WebSocket 端口

调试方式

  1. 使用内置的 MCP 检查器:
npm run inspector
  1. 监控与 Revit 插件的 WebSocket 通信
  2. 检查服务器日志以了解连接和操作状态

常见问题解答

  • 连接失败怎么办? 服务器会自动回退到模拟数据,并尝试重新建立连接。
  • 如何配置服务器路径? 在 Claude Desktop 的配置文件中指定服务器路径。
  • 支持哪些 Revit 版本? 支持 Autodesk Revit 2023 或更高版本。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。