Revitmcp

🚀 Revit MCP 集成

此集成专为 Autodesk Revit 2024.3 打造，借助 Model Context Protocol (MCP) 标准，让 AI 助手（如 Claude）能够以自然语言直接与 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。

快速上手操作

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

✨ 主要特性

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

📦 安装指南

安装 Python

从 python.org 下载并安装 Python 3.13。

安装 Python 包

在命令行中执行以下命令：

pip install mcp[cli] httpx

安装 PyRevit

安装 Revit 2024 的最新版本 PyRevit。

复制扩展文件夹

将 RevitMCP.extension 文件夹复制到 %APPDATA%\pyRevit\extensions 路径下。

重新加载 PyRevit

从 Revit 跑道重新加载 PyRevit。

💻 使用示例

基础用法

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

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

高级用法

配置 Claude Desktop 连接：

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

示例提示

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

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

🔧 技术细节

此集成使用 Model Context Protocol (MCP)，这是由 Anthropic 开发的开放标准，它清晰地定义了 AI 模型如何连接到外部工具和数据源。通过该协议，大型语言模型 (LLMs) 能够实现以下操作：

• 查询 Revit 模型中的信息。
• 创建和修改元素。
• 通过标准化接口执行复杂操作。

📄 许可证

此项目在 MIT License 下发布。

致谢

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

🔧 故障排除

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