Cutom Revit MCP server

Revit MCP服务器

使用Claude AI通过自然语言控制Autodesk Revit。此项目实现了 模型上下文协议（MCP） 该服务器连接了Claude Desktop和Revit 2023，通过61个工具实现了人工智能驱动的BIM操作。

问克劳德 *“列出所有墙”*, *“创建包含建筑立面的图纸”*，或 *“按级别计数门”* 它直接在Revit模型中执行。

建筑

Claude Desktop ──(stdio/MCP)──► TypeScript MCP Server ──(HTTP :8080)──► C# Revit Plugin ──► Revit API

C#插件使用 ExternalEvent 用于线程安全Revit API访问的模式。一 HttpListener 上 localhost:8080 接收工具请求，并通过将其排队 ExternalEvent，并等待结果。

先决条件

• Autodesk Revit 2023 （安装在默认路径 C:\Program Files\Autodesk\Revit 2023\)
• Node.js v18+(下载)
• .NET Framework 4.8开发包 (下载)
• 克劳德桌面版 (下载)

项目结构

revit-mcp-server/
├── RevitPlugin/                    # C# Revit Add-in
│   ├── App.cs                      # Plugin entry point (IExternalApplication)
│   ├── HttpServer.cs               # HTTP server on localhost:8080
│   ├── ExternalEventHandler.cs     # Thread-safe Revit API execution
│   ├── ToolRouter.cs               # Routes tool names to handlers
│   ├── RevitMcpPlugin.csproj       # .NET project file
│   ├── RevitMcpPlugin.addin        # Revit add-in manifest
│   ├── Tools/
│   │   ├── QueryTools.cs           # get_elements, find_elements, quantities
│   │   ├── ElementTools.cs         # create/delete/move/copy elements
│   │   ├── ParameterTools.cs       # get/set parameter values
│   │   ├── ViewTools.cs            # manage views, duplicate, filters
│   │   ├── SheetTools.cs           # create sheets, place viewports
│   │   ├── SelectionTools.cs       # select elements by criteria
│   │   ├── VisibilityTools.cs      # hide/isolate/unhide elements
│   │   ├── LevelGridTools.cs       # levels, grids, rename elements
│   │   ├── MEPTools.cs             # panel schedules, conduit QA, room contents
│   │   ├── AnnotationTools.cs      # tags, duplicate tag detection
│   │   └── ProjectTools.cs         # categories list, warnings
│   └── Helpers/
│       ├── CategoryHelper.cs       # Category name resolution (60+ aliases)
│       ├── UnitHelper.cs           # Unit conversions (mm/m/ft/in)
│       └── JsonHelper.cs           # Element-to-JSON serialization
│
├── mcp-server/                     # TypeScript MCP Server
│   ├── package.json
│   ├── tsconfig.json
│   ├── .env.example
│   └── src/
│       ├── index.ts                # Entry point
│       ├── server.ts               # MCP server setup + tool registration
│       ├── revit-client.ts         # HTTP client for Revit plugin
│       ├── types.ts                # TypeScript interfaces
│       └── tools/
│           ├── query-tools.ts      # Element query tools
│           ├── element-tools.ts    # Element creation/modification tools
│           ├── parameter-tools.ts  # Parameter tools
│           ├── view-tools.ts       # View management tools
│           ├── sheet-tools.ts      # Sheet management tools
│           ├── selection-tools.ts  # Selection tools
│           ├── visibility-tools.ts # Visibility tools
│           ├── level-grid-tools.ts # Level/grid tools
│           ├── mep-tools.ts        # MEP tools
│           ├── annotation-tools.ts # Annotation tools
│           └── project-tools.ts    # Project-wide tools
│
└── README.md

安装说明

步骤1：构建C#Revit插件

1. 打开终端并导航到 RevitPlugin 文件夹：

cd RevitPlugin

1. 还原NuGet包并构建：

dotnet restore
dotnet build -c Release

注： 这 .csproj 参考中的Revit API DLL C:\Program Files\Autodesk\Revit 2023\。如果您的Revit安装在其他地方，请更新 ` 条目在 RevitMcpPlugin.csproj`.

1. 构建输出将在 RevitPlugin\bin\Release\:

- RevitMcpPlugin.dll - Newtonsoft.Json.dll

步骤2：部署Revit插件

将三个文件复制到Revit 2023附加模块文件夹：

# Create target folder variable
set ADDIN_DIR=%APPDATA%\Autodesk\Revit\Addins\2023

# Copy the add-in manifest
copy RevitPlugin\RevitMcpPlugin.addin "%ADDIN_DIR%\"

# Copy the built DLLs
copy RevitPlugin\bin\Release\RevitMcpPlugin.dll "%ADDIN_DIR%\"
copy RevitPlugin\bin\Release\Newtonsoft.Json.dll "%ADDIN_DIR%\"

复制后，文件夹应包含：

%APPDATA%\Autodesk\Revit\Addins\2023\
├── RevitMcpPlugin.addin
├── RevitMcpPlugin.dll
└── Newtonsoft.Json.dll

步骤3：安装MCP服务器依赖项

cd mcp-server
npm install

步骤4：构建MCP服务器

cd mcp-server
npx tsc

这将TypeScript编译为JavaScript mcp-server/dist/ 文件夹。

步骤5：配置Claude桌面

打开Claude Desktop配置文件：

%APPDATA%\Claude\claude_desktop_config.json

添加 revit 进入下 mcpServers:

{
  "mcpServers": {
    "revit": {
      "command": "node",
      "args": [
        "C:\\FULL\\PATH\\TO\\github_revit_MCP_server\\mcp-server\\dist\\index.js"
      ],
      "env": {
        "REVIT_HOST": "localhost",
        "REVIT_PORT": "8080"
      }
    }
  }
}

重要提示： 替换 C:\\FULL\\PATH\\TO\\ 使用项目文件夹的实际绝对路径。使用双反睫毛 \\ JSON格式。

步骤6：启动

1. 启动Revit 2023 并打开一个项目。该插件将自动加载并启动端口8080上的HTTP服务器。您应该看到一个确认对话框。

1. 重新启动克劳德桌面 因此，它采用了新的MCP服务器配置。

1. 开始聊天！ 在Claude Desktop中打开一个新对话，然后尝试：

- *“列出模型中的所有墙”* - *“获取项目信息”* - *“按类型统计所有门”* - *“创建名为建筑立面的新图纸a-501”*

验证连接

您可以独立验证每个组件：

检查Revit插件HTTP服务器：

curl http://localhost:8080/health

预期响应：

{
  "success": true,
  "status": "running",
  "revitConnected": true,
  "documentName": "YourProject.rvt",
  "serverVersion": "1.0.0"
}

直接测试工具调用：

curl -X POST http://localhost:8080/execute -H "Content-Type: application/json" -d "{\"tool\": \"get_project_info\", \"parameters\": {}}"

可用工具（61）

查询工具（10）

元素工具（8）

参数工具（4）

查看工具（6）

板材工具（6）

选择工具（8）

可见性工具（6）

水平和网格工具（4）

MEP工具（5）

注释工具（4）

项目工具（2）

适应其他Revit版本

本项目目标 修订版2023 （.NET Framework 4.8）。要适应其他版本：

Revit 2024+（.NET Framework 4.8）

• 更新 ` 在 .csproj` 指向Revit 2024安装
• 部署到 %APPDATA%\Autodesk\Revit\Addins\2024\
• API应该大部分兼容

Revit 2025+（.NET 8）

• 改变 ` 在 .csproj 从 net48 到 net8.0-windows`
• 更新 `` 到Revit 2025的安装路径
• 替换不推荐使用的API调用（某些 SpecTypeId 图案可能不同）
• 部署到 %APPDATA%\Autodesk\Revit\Addins\2025\

故障排除

Claude Desktop中的“服务器已断开连接”

1. 检查MCP日志： 打开 %APPDATA%\Claude\logs\mcp-server-revit.log
2. 常见修复： 确保你用以下代码构建了TypeScript npx tsc 和路径在 claude_desktop_config.json 指向 dist/index.js 文件（不是 src/index.ts)
3. 路径问题： 这 args 数组必须包含 绝对路径 到 dist/index.js 双睫毛

Revit插件未加载

1. 验证所有3个文件都在 %APPDATA%\Autodesk\Revit\Addins\2023\:

- RevitMcpPlugin.addin - RevitMcpPlugin.dll - Newtonsoft.Json.dll

1. 检查一下 .addin 文件未被阻止：右键单击>属性>取消阻止
2. 部署后重新启动Revit

“工具执行超时”

• Revit可能正忙于其他操作。请稍候，然后重试。
• 大型型号可能需要超过30秒的超时时间

健康检查报告 revitConnected: false

• 确保Revit项目文档已打开（而不仅仅是开始屏幕）

运作原理

1. 克劳德桌面版 发送MCP tools/call 请求（例如。， get_elements 随着 {category: "Walls"})通过stdio
2. 这 TypeScript MCP服务器 接收它，将其转换为HTTP POST localhost:8080/execute
3. 这 C#Revit插件 HttpServer接收请求，在 ExternalEventHandler，并提出 ExternalEvent
4. Revit拾取 ExternalEvent 在其 主线程 并执行Revit API调用
5. 结果返回：Revit API响应->JSON响应->HTTP响应->MCP响应->Claude Desktop

这 ExternalEvent + ManualResetEventSlim 模式确保所有Revit API调用都发生在主线程上（Revit需要），而HTTP服务器可以处理来自后台线程的请求。

变更后的重建

如果修改任何源文件：

C#插件更改：

cd RevitPlugin
dotnet build -c Release
# Re-copy DLLs to Revit addins folder
copy bin\Release\RevitMcpPlugin.dll "%APPDATA%\Autodesk\Revit\Addins\2023\"
# Restart Revit

TypeScript MCP服务器更改：

cd mcp-server
npx tsc
# Restart Claude Desktop

许可证

MIT许可证-请参阅 许可证 了解详情。

致谢

• 模型上下文协议 通过Anthropic
• Revit API文档
• 受启发于 archsalem101/revit mcp服务器