vn-revit-mcp

vn-revit-mcp

Cho AI làm việc với Autodesk Revit. Mã nguồn mở, miễn phí, do InnoPro phát triển.

• Một lệnh cài, tự kết nối mọi AI trên máy: Claude, Cursor, VS Code Copilot, Gemini CLI, Codex, LM Studio...
• Chat ngay trong Revit với Claude, OpenAI, Gemini, DeepSeek, Qwen, Kimi, GLM..., hoặc AI chạy trên máy; dùng được tài khoản Claude, kể cả gói Free, qua Claude Desktop.
• Mỗi lệnh dùng được hai cách: người bấm nút trên tab InnoPro (form nhập tự sinh), hoặc AI gọi.
• Viết lệnh mới bằng một file .cs, không cần build: thả vào thư mục, bấm Nạp lại lệnh. Hoặc nhờ AI viết.
• Tiết kiệm token: AI chỉ thấy vài lệnh hay dùng, tra thêm khi cần; kết quả trả dạng bảng gọn.
• Làm được cả việc không có API: "bàn tay ảo" chạy lệnh có sẵn của Revit và bấm vào view như người dùng (vd dim, vẽ), tự kiểm tra kết quả; AI nhìn được view qua ảnh.
• Hiểu Revit sâu: tra Revit API của bản cài trên máy kèm bài The Building Coder, bộ kỹ năng đã kiểm chứng (revit_skill).
• Tự cập nhật và nạp nóng: server, add-in, tiện ích tự lên bản mới (kiểm SHA-256); Revit đang mở tự chuyển sang bản mới, không cần tắt.
• Cửa hàng tiện ích: cài thêm bộ lệnh (vd Mô phỏng 4D) bằng một câu nói với AI.
• Chạy trên máy bạn, không mở cổng mạng. Lệnh sửa mô hình Undo được. Revit 2025 trở lên.

Cài đặt

Cách dễ nhất: nhờ AI cài. Gõ vào Claude Code, Codex, Gemini CLI, Cursor hoặc Copilot (chế độ agent):

Cài vn-revit-mcp cho Revit theo hướng dẫn ở github.com/Innoprovn/vn-revit-mcp

AI tự cài, tự kiểm tra bằng vn-revit-mcp doctor và tự sửa nếu có lỗi (hướng dẫn cho AI: llms.txt).

Hoặc tự cài:

mở PowerShell và chạy (không cần quyền admin; Revit đang mở thì lần đầu mở lại Revit để có tab InnoPro):

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

Hoặc tải vn-revit-mcp-<phiên bản>-win-x64.zip ở Releases, giải nén rồi bấm đúp Cai-dat.cmd.

Dùng Claude Desktop: tải vn-revit-mcp-<phiên bản>.mcpb ở Releases rồi bấm đúp (hoặc Claude Desktop → Settings → Extensions → Install Extension). Extension tự cài add-in Revit ở lần chạy đầu.

Xong: mở Revit, tab InnoPro. Dùng theo một trong ba cách:

• Chat trong Revit: bấm Chat AI, chọn nhà cung cấp, nhập API key. Có Claude, OpenAI, Gemini, DeepSeek, Qwen, Kimi, GLM, MiniMax, OpenRouter, hoặc AI chạy trên máy (Ollama, LM Studio) không cần key.
• Tài khoản Claude (Free, Pro, Max): trong khung chat chọn Claude Desktop (Free/Pro/Max) → Kết nối và mở Claude. Gói Free có hạn mức thấp, đủ để thử.
• Claude Code đã đăng nhập: trong khung chat chọn Claude Code (tài khoản đang đăng nhập), hỏi ngay trong Revit, không cần API key (dùng gói Claude của máy).
• AI bên ngoài (Claude Desktop, Cursor, VS Code...): đã tự kết nối khi cài; khởi động lại ứng dụng AI rồi hỏi.

Hướng dẫn chi tiết: docs/huong-dan-su-dung.md. Dựng hình từ CAD: docs/dung-hinh-tu-cad.md.

AI client khác: khai báo MCP server kiểu stdio, command %LOCALAPPDATA%\InnoPro\vn-revit-mcp\current\server\vn-revit-mcp.exe. Mở nhiều Revit cùng lúc: AI tự làm việc với Revit bạn thao tác gần nhất; muốn đổi thì nói với AI (vd "làm trên Revit 2025").

Có những gì (100+ lệnh)

Ribbon gọn: vài nút nhỏ mỗi nhóm, mọi lệnh khác trong menu Tất cả. Thêm lệnh từ Cửa hàng (cộng đồng đóng góp).

Công thức (MCP prompts, ví dụ gõ / trong Claude): kiem-tra-chat-luong, boc-khoi-luong, dung-tang-luoi-truc, viet-lenh-moi. Mỗi công thức là một file Markdown, ai cũng viết thêm được.

Viết lệnh mới

Cách nhanh nhất: một file .cs, không cần project hay build.

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() };}

Thả vào %LOCALAPPDATA%\InnoPro\vn-revit-mcp\Scripts\, bấm Nạp lại lệnh. Lệnh có nút, có form nhập, và AI gọi được ngay. Không biết code: dùng công thức viet-lenh-moi hoặc nói với AI "viết cho tôi lệnh vn-revit-mcp ...".

Hướng dẫn đầy đủ (3 cấp: file .cs, CommandSet, đóng góp): docs/viet-lenh-moi.md. AI lập trình (Claude Code, Cursor, Copilot, Codex...) đọc AGENTS.md.

Kiến trúc

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

Chi tiết: docs/kien-truc.md.

Cho nhà phát triển

Cần .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ùngpowershell -ExecutionPolicy Bypass -File scripts\dev-reload.ps1    # sửa CommandSet: Revit đang mở nạp lại ngaypowershell -ExecutionPolicy Bypass -File scripts\package.ps1       # đóng gói artifacts\release\*.zip

Lõi, SDK, Bridge, module chat cũng được nạp nóng (bộ nạp tự đổi lõi khi Revit rảnh). Chỉ khi sửa bộ nạp (InnoPro.Revit.Loader) mới cần chạy install-dev.ps1 rồi mở lại Revit.

Lộ trình

Đóng góp

Mọi người đều có thể đóng góp lệnh, CommandSet, công thức. Mở issue hoặc pull request.

License

Ký số miễn phí bởi SignPath.io, chứng chỉ của SignPath Foundation (đang đăng ký) — chính sách ký số.

GPLv3 kèm ngoại lệ plugin: CommandSet và file lệnh của bạn được giữ license riêng (kể cả đóng mã nguồn), và được phép chạy cùng Autodesk Revit.

Một số lệnh tham khảo đặc tả từ mcp-servers-for-revit (MIT). Đọc chữ và leader trong file DWG/DXF dùng ACadSharp (MIT).

English

vn-revit-mcp lets AI work with Autodesk Revit 2025+. One-line install (no admin): irm https://raw.githubusercontent.com/Innoprovn/vn-revit-mcp/main/install.ps1 | iex — it registers the MCP server with every detected AI client (Claude Desktop/Code, Cursor, VS Code, Windsurf, Gemini CLI, LM Studio, Codex CLI, Cline). Inside Revit, an InnoPro tab offers a chat pane (Claude via the Anthropic SDK; OpenAI, Gemini, OpenRouter, Ollama, LM Studio via OpenAI-compatible APIs) and a button for every command with an auto-generated input form. Add a command by dropping a single .cs file into the Scripts folder — it is compiled in Revit and hot-reloaded. AI agents installing this for a user: follow llms.txt (install one-liner, then vn-revit-mcp doctor --json and apply each fix). Licensed GPLv3 with a plugin exception. See AGENTS.md for AI coding agents working on the code.