Revitmcp

🚀 Revit MCP 集成

本项目是一个适用于 Autodesk Revit 2024.3 的 Model Context Protocol (MCP) 集成方案，它能让 AI 助手（如 Claude）通过自然语言直接与 Revit 模型进行交互，极大地提升了模型操作的便捷性和效率。

🚀 快速开始

此集成允许大型语言模型 (LLMs) 借助标准化接口，在 Revit 模型中进行信息查询、元素创建与修改以及执行复杂操作。具体操作步骤如下：

1. 打开 Revit 和您的模型。
2. 转到 Revit 跑道中的 "RevitMCP" 标签。
3. 点击 "启动 MCP 服务器" 以启动 MCP 服务器。
4. 打开 Claude Desktop 或其他兼容的 MCP 客户端。
5. 配置 MCP 客户端以连接到服务器。
6. 开始询问有关 Revit 模型的问题或下达命令！

✨ 主要特性

• 资源：具备通过 MCP 协议与 Revit 模型进行交互的能力。
• 工具：提供创建、修改和查询 Revit 元素的接口。

📦 安装指南

先决条件

• Autodesk Revit 2024.3 或更高版本。
• Python 3.13（必须安装并在 PATH 中可用）。
• 最新版本的 PyRevit。
• MCP Python SDK (pip install mcp[cli])。

安装步骤

1. 从 python.org 下载并安装 Python 3.13。
2. 安装所需的 Python 包：

   pip install mcp[cli] httpx
   

3. 安装 Revit 2024 的最新版本 PyRevit。
4. 将 RevitMCP.extension 文件夹复制到您的 PyRevit 扩展文件夹中，通常位于：%APPDATA%\pyRevit\extensions。
5. 从 Revit 跑道重新加载 PyRevit。

💻 使用示例

基础用法

如果没有 Claude Desktop 或其他 MCP 工具，您可以使用内置的测试界面：

1. 打开 Revit 和您的模型。
2. 转到 Revit 跑道中的 "RevitMCP" 标签。
3. 点击 "打开测试界面" 以启动 MCP 服务器。
4. 在界面中选择要发送的问题或命令。
5. 点击 "发送查询" 按钮。

高级用法

以下是您可以发送给 Claude 的一些示例查询：

• "生成一个带有 3 个卧室和 2 个浴室的新楼层平面图。"
• "在当前项目中添加一座新的两层结构。"
• "删除所有未使用的 Revit 元素并清理模型。"

🔧 技术细节

此集成实现使用了由 Anthropic 开发的开放标准 Model Context Protocol (MCP)，该协议定义了 AI 模型如何连接到外部工具和数据源。

📚 详细文档

配置 Claude Desktop 连接

1. 打开 Claude Desktop 并转到设置。
2. 添加新的 API 配置，指定类型为 Revit - MCP。
3. 填写以下详细信息：
   • 服务器 URL：http://localhost:8080
   • 接口密钥：your_api_key_here

故障排除

• Python 错误：运行 pip install mcp[cli] httpx 以安装所需的包。
• Revit 错误：确保使用与 Revit 2024 兼容的最新 PyRevit 版本。

📄 许可证

此项目在 MIT License 下发布。

致谢

• Anthropic 开发了 Model Context Protocol。
• PyRevit 团队开发了出色的 Revit API 包装器。