🏗️ Revit MCP 服务器

用于 Revit 集成的模型上下文协议服务器，实现 Claude AI 和 Autodesk Revit 之间的无缝通信。

English |中文

🎯 概述

这款基于 TypeScript 的 MCP 服务器在 Claude AI 和 Revit 之间架起了一座桥梁，允许通过 WebSocket 连接直接与 Revit 模型交互。它实现了模型上下文协议 (MCP)，从而实现以下功能：

• ⚡ 实时访问 Revit 模型信息

• 🔍 元素查询和过滤

• 👀 视图和级别管理

• 🛡️ 使用后备模拟数据进行强大的错误处理

Related MCP server: QGISMCP

✨ 特点

🔌 Revit 集成

• 📡 基于 WebSocket 与 Revit 插件的通信

• 🔄 实时模型数据访问

• 🔁 连接失败时优雅地回退到模拟数据

• ⚙️ 通过环境变量配置连接设置

🚀 核心功能

• 📊 模型信息

  • 访问基本模型元数据（名称、路径、版本）

  • 获取元素计数和最后修改日期

  • 实时模型状态同步

• 🏗️元素管理

  • 具有灵活过滤功能的查询元素

  • 访问元素属性和几何形状

  • 批量元素操作

• 🎪 视图和级别控制

  • 列出所有可用视图

  • 访问级别信息

  • 浏览模型层次结构

💻 开发

📋 先决条件

• Node.js（v14 或更高版本）

• npm

• Autodesk Revit（2023 或更高版本）

• Revit WebSocket 插件（配套插件）

🔧 安装

安装依赖项：

npm install

构建服务器：

npm run build

对于使用自动重建的开发：

npm run watch

⚙️ 配置

可以使用环境变量来配置服务器：

REVIT_HOST=127.0.0.1    # Revit plugin WebSocket host
REVIT_PORT=8080         # Revit plugin WebSocket port

🔗 与 Claude Desktop 集成

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

视窗：

%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 连接失败时自动回退到模拟数据

• 详细的错误日志记录

• 优雅的连接恢复

📄 许可证

MIT 许可证

🤝 贡献

欢迎贡献代码！欢迎随时提交 Pull Request。

📬 联系方式

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

• 📧邮箱： 353554036@qq.com

• 💬 微信账号：modian4500