Revit MCP

🚀 🏗️ Revit MCP 服务器

一款基于 TypeScript 的模型上下文协议（Model Context Protocol）服务器，用于实现Claude AI与Autodesk Revit之间的无缝集成，允许直接通过 WebSocket 连接访问 Revit 模型，为建筑模型数据的交互提供了便捷途径。

🚀 快速开始

此 TypeScript 基础的 MCP 服务器充当 Claude AI 和 Revit 之间的桥梁，允许通过 WebSocket 连接实时访问 Revit 模型信息。借助该服务器，用户能够实时获取 Revit 模型信息、进行元素查询与筛选、管理视图和楼层，同时具备健壮的错误处理及 mock 数据回退机制。

✨ 主要特性

🔌 Revit 集成

• 📡 通过 WebSocket 实现 Revit 插件通信，确保数据传输的高效性。
• 🔄 支持实时模型数据访问，让用户及时获取最新信息。
• 🔁 连接失败时自动回退到 mock 数据，保障服务的稳定性。
• ⚙️ 通过环境变量配置连接设置，方便灵活调整。

🚀 核心功能

• 📊 模型信息
  • 可获取基本模型元数据（名称、路径、版本），掌握模型基本情况。
  • 能获取元素数量和最后修改日期，了解模型更新状态。
  • 支持实时同步模型状态，保证信息的及时性。
• 🏗️ 元素管理
  • 可以使用灵活过滤器查询元素，精准定位所需信息。
  • 能够访问元素属性和几何形状，深入了解元素特征。
  • 支持批量操作元素，提高工作效率。
• 🎪 视图与楼层控制
  • 可列出所有可用视图，方便切换查看。
  • 能获取楼层信息，了解建筑结构。
  • 支持遍历模型层次结构，全面掌握模型架构。

📦 安装指南

📋 先决条件

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

🔧 安装步骤

安装依赖：

npm install

构建服务器：

npm run build

开发时自动重建：

npm run watch

⚙️ 配置

服务器可通过环境变量进行配置：

REVIT_HOST=127.0.0.1    # Revit 插件 WebSocket 服务端地址
REVIT_PORT=8080         # Revit 插件 WebSocket 端口

🔗 与 Claude Desktop 集成

将服务器配置添加到 Claude Desktop： Windows:

%APPDATA%/Claude/claude_desktop_config.json

配置格式：

{
  "mcpServers": {
    "revit-mcp-server": {
      "command": "D:/path/to/revit-mcp-server/build/index.js"
    }
  }
}

🐛 调试

调试 MCP 通信：

1. 使用内置的 MCP 检查工具：

npm run inspector

2. 监控与 Revit 插件之间的 WebSocket 通信。
3. 查看服务器日志获取连接和操作状态信息。

⚠️ 错误处理

服务器实现了健壮的错误处理机制：

• 连接 Revit 失败时自动回退到 mock 数据，确保系统稳定运行。
• 详细的错误记录，方便排查问题。
• 平滑的连接恢复，减少对用户的影响。

📄 许可证

本项目采用 MIT License。

🤝 贡献

欢迎贡献！请随意提交拉取请求。

📬 联系方式

如有任何问题或建议，请随时联系：

• 📧 电子邮箱：353554036@qq.com
• 💬 微信账号：modian4500