vn-revit-mcp

vn-revit-mcp

让 AI 使用 Autodesk Revit。 由 InnoPro 开发，免费开源。

• 一条命令即可安装，自动连接本机上的所有 AI：Claude、Cursor、VS Code Copilot、Gemini CLI、Codex、LM Studio……
• 直接在 Revit 中聊天：支持 Claude、OpenAI、Gemini、DeepSeek、Qwen、Kimi、GLM……或本机运行的 AI；也可通过 Claude Desktop 使用 Claude 账户，包括 Free 套餐。
• 每条命令都有两种使用方式： 用户可在 InnoPro 选项卡中点击按钮（自动生成输入表单），也可由 AI 调用。
• 用一个 .cs 文件编写新命令，无需构建：将文件放入目录，然后点击 重新加载命令。也可以让 AI 编写。
• 节省 token： AI 只会看到几条常用命令，需要时再查询其他命令；结果以简洁表格形式返回。
• 也能完成没有 API 的工作： “虚拟之手”可以像用户一样运行 Revit 的现有命令并点击视图（例如标注、绘图），还能自动检查结果；AI 可以通过图像查看视图。
• 深入理解 Revit： 查询本机安装版本的 Revit API，以及 The Building Coder 文章和经过验证的技能集（revit_skill）。
• 自动更新并热加载： 服务、插件和工具会自动更新到新版本（验证 SHA-256）；Revit 打开时会自动切换到新版本，无需关闭。
• 工具商店： 只需对 AI 说一句话，即可安装其他命令集（例如 4D 模拟）。
• 在你的电脑上运行，不开放网络端口。修改模型的命令支持撤销。Revit 2025 或更高版本。

安装

最简单的方法：让 AI 安装。 在 Claude Code、Codex、Gemini CLI、Cursor 或 Copilot（Agent 模式）中输入：

按照 github.com/Innoprovn/vn-revit-mcp 中的说明，为 Revit 安装 vn-revit-mcp

AI 会自动安装，使用 vn-revit-mcp doctor 自动检查，并在出现错误时自动修复（AI 使用说明：llms.txt）。

也可以自行安装：

打开 PowerShell 并运行（无需管理员权限；如果 Revit 已打开，首次安装后请重新打开 Revit 以显示 InnoPro 选项卡）：

irm https://raw.githubusercontent.com/Innoprovn/vn-revit-mcp/main/install.ps1 | iex

或者从 Releases 下载 vn-revit-mcp-<phiên bản>-win-x64.zip， 解压后双击 Cai-dat.cmd。

使用 Claude Desktop： 从 Releases 下载 vn-revit-mcp-<phiên bản>.mcpb 并双击（或在 Claude Desktop → Settings → Extensions → Install Extension 中安装）。扩展会在首次运行时自动安装 Revit 插件。

完成后：打开 Revit，进入 InnoPro 选项卡。可通过以下三种方式使用：

• 在 Revit 中聊天： 点击 Chat AI，选择提供商并输入 API 密钥。支持 Claude、OpenAI、Gemini、DeepSeek、Qwen、Kimi、 GLM、MiniMax、OpenRouter，或无需密钥的本机 AI（Ollama、LM Studio）。
• Claude 账户（Free、Pro、Max）： 在聊天窗口中选择 Claude Desktop (Free/Pro/Max) → 连接并打开 Claude。Free 套餐的使用额度较低，适合试用。
• 已登录的 Claude Code： 在聊天窗口中选择 Claude Code (当前登录账户)，即可在 Revit 中直接提问，无需 API 密钥（使用本机的 Claude 套餐）。
• 外部 AI（Claude Desktop、Cursor、VS Code……）：安装时已自动连接；重启 AI 应用后即可提问。

详细指南：docs/huong-dan-su-dung.md。从 CAD 建模：docs/dung-hinh-tu-cad.md。

事项	操作方法
连接其他 AI 客户端	在 Revit 中点击 系统 → 连接 AI
更新	自动更新：每次打开 Revit 或 AI 时检查，最多每 12 小时一次（验证 SHA-256，marketplace 工具也会自动更新）。立即更新：vn-revit-mcp.exe update。关闭自动更新：环境变量 VN_REVIT_MCP_AUTO_UPDATE=0
卸载	使用 zip 文件中的 uninstall.ps1（添加 -Purge 可同时删除所有自行添加的命令）
Revit 的“Load Once”对话框	安装程序已为 vn-revit-mcp 预先设置 Always Load，因此 Revit 不会询问。若要让 Revit 询问：使用 -NoTrust 安装。数字签名：政策

其他 AI 客户端：将 MCP 服务配置为 stdio 类型，命令为 %LOCALAPPDATA%\InnoPro\vn-revit-mcp\current\server\vn-revit-mcp.exe。 同时打开多个 Revit 时：AI 会自动操作你最近使用的 Revit；若要切换，请告诉 AI（例如“在 Revit 2025 中操作”）。

包含内容（100+ 条命令）

类别	示例
查询、参数	项目/视图信息、当前选中的元素、查找元素、参数、统计；批量修改参数
QA-QC	警告、重复元素（查找/删除）、空参数、碰撞、与链接模型碰撞、模型健康状况、标注到轴网的尺寸
建模	楼层、轴网、墙、梁、楼板、放置族；按梁生成楼板、合并/拆分楼板、自动连接、墙面饰层
CAD 建模	从 CAD 图纸创建墙、楼板/天花板、柱、梁、桩 + 承台、门；从截面创建梁类型
Rebar	BBS 类型统计、快速选择、取消/添加宿主、移动钢筋、避让碰撞、钢筋 QA、比较变更、形状库
图纸	创建图纸、放置视图、复制视图、指定样板、自动标记、轴网尺寸标注、导出 PDF
数据	读取/导出明细表、材料工程量、墙长、图纸列表、在链接模型中查找元素
高级	run_csharp：AI 运行 C# 代码；默认只读；mode=write 可直接修改模型，并可撤销

简洁的 Ribbon：每组几个小按钮，其他命令都在全部菜单中。从商店添加命令（社区贡献）。

提示词（MCP 提示词，例如在 Claude 中输入 /）：kiem-tra-chat-luong、boc-khoi-luong、dung-tang-luoi-truc、 viet-lenh-moi。每个提示词都是一个 Markdown 文件，任何人都可以编写更多。

编写新命令

最快的方法：一个 .cs 文件，无需项目或构建。

public sealed class CountWalls : RevitCommandBase
{
    public override string Name => "count_walls";
    public override string Category => "Của tôi";
    public override string Description => "Đếm số tường trong mô hình.";
    public override RibbonButton Ribbon => new("Đếm\ntường", "#");   // có nút trên ribbon

    public override object Execute(RevitCommandContext context, JsonElement arguments) =>
        new { count = new FilteredElementCollector(context.Document).OfClass(typeof(Wall)).GetElementCount() };
}

将文件放入 %LOCALAPPDATA%\InnoPro\vn-revit-mcp\Scripts\，点击重新加载命令。命令会立即拥有按钮和输入表单，并可供 AI 调用。 如果不会编程：使用 viet-lenh-moi 提示词，或告诉 AI “为我编写 vn-revit-mcp 命令……”。

完整指南（3 个级别：.cs 文件、CommandSet、贡献）：docs/viet-lenh-moi.md。 AI 编程工具（Claude Code、Cursor、Copilot、Codex 等）请阅读 AGENTS.md。

架构

AI client ──MCP (stdio)──▶ vn-revit-mcp.exe ──named pipe──▶ Add-in InnoPro (trong Revit) ──▶ Revit API
Khung chat trong Revit ──────────────────────────────────────▲      ├─ CommandSet (DLL)
                                                                    └─ Scripts (*.cs, tự biên dịch)

组件	作用
src/InnoPro.Revit.Sdk	编写命令的接口：RevitCommandBase、Args、Table、Lookup、UnitConvert
src/InnoPro.Revit.Loader	加载器（InnoPro.Revit.Addin.dll）：Revit 直接加载；有新版本时自动热加载核心
src/InnoPro.Revit.Addin	核心（InnoPro.Revit.Core.dll）：自动生成 Ribbon、自动生成表单、热加载命令、桥接器、聊天面板
src/InnoPro.Revit.Chat	聊天模块（单独加载）：通过 Anthropic SDK 接入 Claude，其他 AI 通过兼容 OpenAI 的 API 接入
src/InnoPro.Bridge	Named Pipe 协议、共享命令查找
src/InnoPro.Mcp.Server	MCP 服务、提示词、用于配置 AI 客户端的 setup 命令
src/InnoPro.Revit.Commands.*	附带的 CommandSet：Core、QA-QC、Modeling、Data、Code

详情：docs/kien-truc.md。

面向开发者

需要 .NET SDK 8。

powershell -ExecutionPolicy Bypass -File scripts\install-dev.ps1   # build + cài bản "dev", cùng bố cục với người dùng
powershell -ExecutionPolicy Bypass -File scripts\dev-reload.ps1    # sửa CommandSet: Revit đang mở nạp lại ngay
powershell -ExecutionPolicy Bypass -File scripts\package.ps1       # đóng gói artifacts\release\*.zip

核心、SDK、Bridge 和聊天模块也支持热加载（Revit 空闲时，加载器会自动更换核心）。只有修改加载器（InnoPro.Revit.Loader）时，才需要运行 install-dev.ps1，然后重新打开 Revit。

路线图

阶段	内容	状态
P0	Add-in、InnoPro 选项卡、桥接器、MCP 服务	✅
P1	CommandSet Core、QA-QC、Modeling、Data、Code；通过 .cs 文件添加命令；自动生成按钮和表单；节省 Token	✅（持续扩展）
P2	Revit 内支持多服务商的聊天面板	✅ 首个版本
P3	一行命令安装器、自动配置 AI 客户端；发布到 GitHub、MCP Registry、自动更新	✅
P4	专业命令集（结构、Rebar、图纸、从 CAD 绘图）；社区命令商店	⏳

贡献

任何人都可以贡献命令、CommandSet 和提示词。欢迎提交 issue 或 pull request。

许可证

由 SignPath.io 免费进行代码签名，使用 SignPath Foundation 的证书（正在申请中）——代码签名政策。

GPLv3 附带插件例外：CommandSet 和你的命令文件保留各自的许可证 （即使闭源），并允许与 Autodesk Revit 一同运行。

部分命令参考了 mcp-servers-for-revit 的规范（MIT）。 使用 ACadSharp（MIT）读取 DWG/DXF 文件中的文字和引线。

---

English

vn-revit-mcp 让 AI 能够操作 Autodesk Revit 2025+。一行命令即可安装（无需管理员权限）： irm https://raw.githubusercontent.com/Innoprovn/vn-revit-mcp/main/install.ps1 | iex — 它会将 MCP 服务注册到所有检测到的 AI 客户端（Claude Desktop/Code、Cursor、VS Code、Windsurf、Gemini CLI、LM Studio、Codex CLI、Cline）。 在 Revit 中，InnoPro 选项卡提供一个聊天面板（通过 Anthropic SDK 使用 Claude；通过 OpenAI 兼容 API 使用 OpenAI、Gemini、OpenRouter、Ollama、LM Studio），以及每个命令对应的按钮，并自动生成输入表单。 只需将单个 .cs 文件放入 Scripts 文件夹，即可添加命令——它会在 Revit 中编译并热重载。 为用户安装此工具的 AI Agent： 请遵循 llms.txt（先运行一行安装命令，然后执行 vn-revit-mcp doctor --json 并应用每项 fix）。 采用 GPLv3 和插件例外许可。负责开发此代码的 AI 编码 Agent 请参阅 AGENTS.md。