🏗️ Revit MCP Server

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

English | 中文

🎯 概览

这个基于TypeScript的MCP服务器为Claude AI和Revit之间提供了一个桥梁，允许通过WebSocket连接直接与Revit模型进行交互。它实现了模型上下文协议以支持：

• ⚡ 实时访问Revit模型信息
• 🔍 元素查询和筛选
• 👀 视图和层级管理
• 🛡️ 强大的错误处理机制，并在连接失败时回退到模拟数据

✨ 特性

🔌 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桌面版集成

将服务器配置添加到Claude桌面版中：

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

1. 监控与Revit插件的WebSocket通信
2. 检查服务器日志以获取连接和操作状态

⚠️ 错误处理

服务器实现了强大的错误处理机制：

• 当Revit连接失败时自动回退到模拟数据
• 详细的错误日志记录
• 优雅的连接恢复

📄 许可证

MIT许可证

🤝 贡献

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

📬 联系方式

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

• 📧 邮箱: 353554036@qq.com
• 💬 微信账号: modian4500