🏗️ Revit MCP 服务器
用于 Revit 集成的模型上下文协议服务器,实现 Claude AI 和 Autodesk Revit 之间的无缝通信。
English |中文
🎯 概述
这款基于 TypeScript 的 MCP 服务器在 Claude AI 和 Revit 之间架起了一座桥梁,允许通过 WebSocket 连接直接与 Revit 模型交互。它实现了模型上下文协议 (MCP),从而实现以下功能:
- ⚡ 实时访问 Revit 模型信息
- 🔍 元素查询和过滤
- 👀 视图和级别管理
- 🛡️ 使用后备模拟数据进行强大的错误处理
✨ 特点
🔌 Revit 集成
- 📡 基于 WebSocket 与 Revit 插件的通信
- 🔄 实时模型数据访问
- 🔁 连接失败时优雅地回退到模拟数据
- ⚙️ 通过环境变量配置连接设置
🚀 核心功能
- 📊 模型信息
- 访问基本模型元数据(名称、路径、版本)
- 获取元素计数和最后修改日期
- 实时模型状态同步
- 🏗️元素管理
- 具有灵活过滤功能的查询元素
- 访问元素属性和几何形状
- 批量元素操作
- 🎪 视图和级别控制
💻 开发
📋 先决条件
- Node.js(v14 或更高版本)
- npm
- Autodesk Revit(2023 或更高版本)
- Revit WebSocket 插件(配套插件)
🔧 安装
安装依赖项:
构建服务器:
对于使用自动重建的开发:
⚙️ 配置
可以使用环境变量来配置服务器:
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 通信:
- 使用内置的 MCP 检查器:
- 使用 Revit 插件监控 WebSocket 通信
- 检查服务器日志以了解连接和操作状态
⚠️ 错误处理
服务器实现了强大的错误处理:
- Revit 连接失败时自动回退到模拟数据
- 详细的错误日志记录
- 优雅的连接恢复
📄 许可证
MIT 许可证
🤝 贡献
欢迎贡献代码!欢迎随时提交 Pull Request。
📬 联系方式
如果您有任何问题或建议,请随时联系我们: