Revitmcpbridge

RevitMCPBridge

Give AI full read-write access to Autodesk Revit. 705+ endpoints. Zero manual steps.

Quick Start · What It Enables · API Reference · Autonomy Levels

______________________________________________________________________

这是什么？

RevitMCPBridge是一个Revit插件，通过命名管道通过模型上下文协议（MCP）公开整个Revit API。人工智能系统——Claude、GPT、自定义代理——可以以编程方式读取、创建、修改和验证Revit模型中的任何内容。没有迪纳摩。没有手动步骤。只需发送JSON，即可获取结果。

对于AEC专业人员： 您的AI助手现在可以打开Revit模型 *做事* --创建墙、放置门、生成图纸、检查代码合规性、生成施工图。

对于开发者： 705+个类型化端点，具有参数验证、事务管理和结构化错误响应。将任何可以写入的语言连接到命名管道。

前后

在RevitMCPBridge之前：

You: "Create a sheet set for these 12 floor plans"
AI:  "Here are the steps you should follow manually in Revit:
      1. Go to View > Sheet Composition > New Sheet
      2. Select your title block...
      3. Repeat 12 times..."

在RevitMCPBridge之后：

# AI executes directly in Revit
for i, view_id in enumerate(floor_plan_ids):
    call_revit("createSheet", {
        "sheetNumber": f"A1.{i+1}",
        "sheetName": f"Floor Plan - Level {i+1}",
        "titleBlockName": "E1 30x42 Horizontal"
    })
    call_revit("placeViewOnSheet", {
        "sheetId": sheet_id,
        "viewId": view_id,
        "locationX": 1.5,
        "locationY": 1.0
    })
# 12 sheets created, views placed, titled — in seconds

它能带来什么

规模

• 705+MCP端点 超过25个类别
• 146个C#源文件，13000多条线路
• 113个知识档案 建筑领域专业知识（建筑规范、房间标准、MEP系统、材料规格）
• 68个单元测试 使用NUnit
• 5个自治级别 -从API直接调用到自主目标执行

API类别

快速开始

先决条件

• Autodesk Revit 2025或2026
• .NET Framework 4.8
• Visual Studio 2022（用于从源代码构建）

安装

# Option 1: Installer script
git clone https://github.com/WeberG619/RevitMCPBridge2026.git
cd RevitMCPBridge2026
.\scripts\deploy\Install-RevitMCPBridge.ps1

# Option 2: Manual
msbuild RevitMCPBridge2026.csproj /p:Configuration=Release
copy bin\Release\RevitMCPBridge2026.dll "%APPDATA%\Autodesk\Revit\Addins\2026\"
copy RevitMCPBridge2026.addin "%APPDATA%\Autodesk\Revit\Addins\2026\"
copy appsettings.json "%APPDATA%\Autodesk\Revit\Addins\2026\"

连接

启动Revit，然后从任何语言启动：

import struct, json

PIPE_NAME = r'\\.\pipe\RevitMCPBridge2026'

def call_revit(method, params=None):
    """Call any Revit method via named pipe."""
    import win32file, win32pipe
    handle = win32file.CreateFile(
        PIPE_NAME, win32file.GENERIC_READ | win32file.GENERIC_WRITE,
        0, None, win32file.OPEN_EXISTING, 0, None
    )
    request = json.dumps({"method": method, "params": params or {}}).encode()
    win32file.WriteFile(handle, struct.pack(' **注：** 网桥通过Windows命名管道进行通信(`\\.\pipe\RevitMCPBridge2026`)不是HTTP。这提供了与Revit的直接进程内通信。有关更简单的Python包装器，请参阅 `python/` 目录。

### 你的第一堵墙

Create a wall

result = call_revit("createWall", { "startX": 0, "startY": 0, "endX": 20, "endY": 0, "wallTypeName": "Generic - 8\"", "levelName": "Level 1", "height": 10 }) print(result)

{"success": true, "elementId": 123456, "length": 20.0}

## 自治级别

该桥支持5个级别的AI自主性：

|级别|名称|功能|
|---|---|---|
| **1** |基本桥接| API直接翻译。发送方法，获取结果。 |
| **2** |上下文感知|跟踪元素关系，维护会话上下文。 |
| **3** |学习和记忆|存储更正，学习模式以供将来使用。 |
| **4** |主动智能|检测工作流程差距，建议下一步行动，预测需求。 |
| **5** |完全自主|通过自我修复和护栏执行高级目标。 |

### 5级示例

"Set up construction document sheets" — one command

call_revit("executeGoal", { "goalType": "create_sheet_set", "parameters": { "viewIds": [123456, 234567, 345678], "sheetPattern": "A-{level}.{sequence}" } })

Creates sheets, places views, adds title blocks, numbers everything

Safety guardrails

call_revit("configureAutonomy", { "maxElementsPerTask": 100, "allowedMethods": ["createWall", "placeDoor", "createSheet"], "blockedMethods": ["deleteElements"], "requireApprovalFor": ["deleteSheet"] })

## 知识库

该桥包括113个建筑领域知识文件：

|类别|文件|覆盖范围|
|---|---|---|
|建筑类型|17|住宅、商业、医疗、教育、酒店、工业|
|建筑规范|15|IBC，佛罗里达建筑规范（完整），纽约市，加利福尼亚州，芝加哥|
|结构和围护结构|12|基础、框架、墙壁、屋顶、玻璃、大块木材|
|MEP系统|10|暖通空调、电气、管道、消防、电梯|
|室内和装修|9|厨房/浴室、材料、木制品、声学、门用五金|
|规范和监管|9|无障碍、出口、能源、分区、许可|
|项目交付|10|成本估算、规范、施工管理|
|文档|7|CD标准、注释标准、详细信息库|

这个知识库使AI代理能够做出符合代码、架构正确的决策，而不需要用户指定每个标准。

## 与自主引擎的连接

RevitMCPBridge是 [自主引擎](https://github.com/WeberG619/claude-ai-tools).连接时：

- **目标跟踪** --“设置此项目”成为一个带有子目标和进度的跟踪目标
- **纠正学习** --BIM特定错误被存储并注入到未来的Revit任务中
- **对齐注射** --每个Revit代理都会得到BIM域的编译更正
- **协调** --多个代理可以在具有资源锁定的同一模型上工作

User Goal: "Create construction documents" ↓ Autonomy Engine decomposes into plan: 1. Create sheet set (SheetMethods) 2. Place views on sheets (ViewMethods) 3. Add annotations (AnnotationMethods) 4. Generate schedules (ScheduleMethods) 5. QC check (Intelligence) ↓ Each step gets BIM-domain alignment injection ↓ Corrections from past sessions prevent known mistakes ↓ Progress cascades to parent goal: 100%

## 配置

{ "Pipe": { "Name": "RevitMCPBridge2026", "TimeoutMs": 30000, "MaxConnections": 5 }, "Logging": { "Level": "Information", "LogDirectory": "%APPDATA%/RevitMCPBridge/logs" }, "Autonomy": { "Enabled": true, "MaxRetries": 3, "MaxElementsPerBatch": 100 } }

## 建筑

graph LR subgraph "AI Side" CL[Claude / GPT / Custom Agent] AE[Autonomy Engine] CL --> AE end

subgraph "Bridge" NP[Named Pipe Server] MR[Method Router] TV[Transaction Validator] NP --> MR --> TV end

subgraph "Revit Side" RA[Revit API] DOC[Active Document] TV --> RA --> DOC end

AE --> |JSON over pipe| NP DOC --> |result| NP --> |JSON response| AE

style CL fill:#4A90D9,color:#fff style AE fill:#E74C3C,color:#fff style NP fill:#2ECC71,color:#fff style RA fill:#F39C12,color:#fff

## 发展

Build

msbuild RevitMCPBridge2026.csproj /p:Configuration=Release

Run tests

dotnet test tests/RevitMCPBridge.Tests.csproj

Smoke test (requires Revit running)

python tests/smoke_test.py

## 故障排除

|问题|解决方案|
|---|---|
|连接被拒绝|确保Revit正在运行并加载了加载项（检查功能区）|
|找不到方法|运行 `getMethods` 列出可用的方法。名称区分大小写。 |
|操作失败|检查文档是否已打开。验证元素ID是否存在。 |
|超时|关闭所有阻塞的Revit对话框。在绘图区域中单击。 |

## 许可证

MIT许可证。看 [许可证](LICENSE).

## 作者

**韦伯古因** — [BIM运营工作室](https://bimopsstudio.com)

第一个通过模型上下文协议将AI连接到Autodesk Revit的开源桥梁。

______________________________________________________________________

  Stop describing Revit workflows to AI. Start executing them.