vn-revit-mcp

Bộ công cụ tiếng Việt để dùng Claude (hoặc AI khác hỗ trợ MCP) với Autodesk Revit, gồm hai phần:

Hai phần chạy song song: Claude dùng phần A để dựng, rồi dùng phần B để kiểm lại khối lượng vừa dựng.

Trạng thái: bản thử 0.2.0. Hãy thử trên một mô hình nháp trước. Gặp lỗi xin mở Issue.

---

Mục lục

1. Cách hoạt động
2. Yêu cầu
3. Cài đặt
4. Vẽ trên Revit bằng Claude
5. Thống kê và khối lượng
6. An toàn và dữ liệu
7. Xử lý lỗi
8. Gỡ cài đặt
9. Phát triển
10. Liên quan đến pyRevit và nguồn tham khảo

---

1. Cách hoạt động

                     Claude Code / Claude Desktop / Cursor ...
                       │                              │
          MCP "pyrevit" (vẽ)                MCP "vn-revit" (thống kê)
          + skill ve-revit                            │
                       │                              │ gọi lệnh: pyrevit agent run 
                       ▼                              ▼
                 pyRevit CLI ──(đường ống nội bộ Windows, không mở cổng mạng)──►
                 pyRevit agent host trong Revit ──► Revit API ──► mô hình đang mở

Phần A, vẽ: Claude tự viết một đoạn Python dùng Revit API (ví dụ “tạo 4 bức tường 200 quanh lô 5x15 m”) rồi gửi qua công cụ run_modify của pyRevit. pyRevit chạy đoạn code đó bên trong Revit, gom mọi thay đổi vào một nhóm, rồi hiện hộp Keep / Discard ngay trong Revit. Bạn bấm Keep thì thay đổi được lưu thành một mục Undo; bấm Discard thì mô hình trở lại như cũ.

Skill ve-revit là “sổ tay” dạy Claude làm việc này theo cách của người Việt: số liệu mm, cốt ±0.000 tại sàn tầng 1, dựng từng chặng, chạy thử trước khi chạy thật, tra loại tường, cửa có sẵn trong mô hình thay vì đoán tên, không tự bịa kích thước.

Phần B, thống kê: vn-revit-mcp chỉ chạy 9 script viết sẵn trong gói. AI không gửi code tùy ý qua phần này được. 10 trên 11 công cụ chỉ đọc mô hình.

2. Yêu cầu