🚀 xml.Revit.MCP 工具概述

xml.Revit.MCP 提供了一套全面的工具集，用于通过模型上下文协议（Model Context Protocol, MCP）与 Autodesk Revit 进行集成。此库充当 AI 助手和 Revit 之间的桥梁，可实现强大的自动化功能，并支持对建筑模型进行编程交互。

🚀 快速开始

xml.Revit.MCP 作为 AI 助手与 Revit 之间的桥梁，借助模型上下文协议，实现了二者的集成，可对建筑模型进行编程交互，还能实现强大的自动化功能。

✨ 主要特性

该工具库包含众多用于 Revit 自动化和交互的功能：

基础操作

• 获取 Revit 插件的可用命令
• 执行指定的 Revit 命令
• 调用具有参数的特定 Revit 函数
• 获取视图数据和选定元素

元素管理

• 按类别查找元素
• 获取元素的参数和位置
• 更新元素参数
• 删除元素
• 在当前视图中显示/高亮元素
• 将元素移动到新位置

创建工具

• 创建楼层/平面
• 创建平面布局视图
• 创建网格线
• 创建墙和地板
• 创建房间和房间标签
• 创建门和窗
• 创建 MEP 元素（风管、管道、桥架）
• 创建族实例
• 链接 DWG 文件
• 创建图纸

📦 安装指南

安装要求

• xml.Revit：版本 1.3.4.3 或更高版本
• Python：3.10 或更高版本
• UV 包管理器：安装所需的工具
• Revit：兼容 2019 - 2024 年版本（需插件）

安装步骤

1. 首先安装 UV 包管理器：

   pip install uv
   

2. 安装 revit - mcp 包：

   pip install revit-mcp
   

3. 测试安装：

   uvx revit-mcp
   

   你应该看到：RevitMCPServer - INFO - 成功连接到 Revit

📚 详细文档

与 AI 助手集成

Claude for Desktop

编辑 claude_desktop_config.json 文件，添加以下内容：

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Cursor

编辑 mcp.json 文件，添加以下内容：

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Cline

编辑 cline_mcp_setting.json 文件，添加以下内容：

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

扩展功能

你可以通过创建自定义 MCP DLL 文件来实现更多功能：

1. 实现 xml.Revit.MCP.Public.IMCPMethod 接口
2. 遵循 JSON - RPC 2.0 规范进行通信
3. 编译为 DLL 文件并放置在指定的 MCP 文件夹中

插件配置

使用 revit - mcp - plugin 时：

1. 在 Revit 中注册插件
2. 通过：添加项 → Revit MCP 插件 → 设置 进行命令配置
3. 启用服务：添加项 → Revit MCP 插件 → Revit MCP 开关

启用后，AI 助手可以发现并控制你的 Revit 程序，执行 xml.Revit.MCP 工具库提供的各种命令。