vn-revit-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VN_REVIT_MCP_REVIT | No | Revit version to target when multiple Revit instances are open (e.g., 2025) to resolve ambiguous_revit error. | |
| VN_REVIT_MCP_PYREVIT | No | Path to pyrevit.exe when the `pyrevit` command is not found (e.g., cli_not_found error). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kiem_tra_ket_noiA | Kiểm tra pyRevit và các phiên Revit đang chạy agent host. Gọi đầu tiên. |
| thong_tin_du_anD | Tên mô hình, phiên bản Revit, danh sách tầng (cao độ m), view đang mở, phase. |
| dem_theo_hang_mucC | Đếm số phần tử mô hình theo từng hạng mục (category). |
| thong_ke_cuaA | Thống kê cửa đi, cửa sổ theo family, loại, kích thước (mm) và tầng. chi_tiet=True trả thêm từng cửa (id, tầng, cao bệ, ký hiệu). |
| thong_ke_phongB | Danh sách phòng: số, tên, tầng, diện tích (m2), chu vi (m); tổng theo tầng; phòng lỗi. |
| khoi_luong_tuongB | Khối lượng tường theo loại và tầng: chiều dài (m), diện tích (m2), thể tích (m3), độ dày (mm). |
| khoi_luong_sanB | Khối lượng sàn theo loại và tầng: diện tích (m2), thể tích (m3), độ dày (mm). |
| khoi_luong_ket_cauB | Thể tích (m3) cột, dầm, móng kết cấu theo vật liệu và loại. |
| kiem_tra_tham_soB | Tìm phần tử của một hạng mục chưa có hoặc để trống một tham số. hang_muc: tên BuiltInCategory (OST_Doors) hoặc tên quen dùng (cua, tuong, phong, cot, dam...). tham_so: tên tham số đúng như trong Revit, ví dụ "Mark" hoặc "Comments". |
| xuat_excel_khoi_luongA | Xuất bảng khối lượng (tường, sàn, kết cấu, cửa, phòng) ra file Excel. thu_muc: thư mục tuyệt đối để lưu; bỏ trống thì lưu vào Documents\vn-revit-mcp. File đánh số NN_ và không bao giờ ghi đè. Hao hụt và mã hiệu để trống cho kỹ sư điền. Chỉ đọc mô hình, không sửa gì trong Revit. |
| dat_tham_soA | Gán giá trị cho một tham số trên tối đa 200 phần tử. chay_thu=True (mặc định): chỉ xem trước, mô hình được hoàn tác. chay_thu=False: sửa thật; Revit hiện hộp duyệt, người dùng bấm Giữ hoặc Hủy. Tham số độ dài, diện tích nhận giá trị theo đơn vị hiển thị của dự án (ví dụ "2500" mm). Chỉ dùng chay_thu=False khi người dùng đã đồng ý rõ ràng. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Tools target distinct Revit data types and operations: connection check, project info, room statistics, category counts, specific quantity takeoffs (structure, walls, floors, doors), parameter auditing/editing, and Excel export. Minor overlap exists between generic category counting (dem_theo_hang_muc) and specialized quantity tools, but descriptions clarify the intended scope.
All tool names use Vietnamese snake_case with no camelCase or mixed casing. Most follow an action_object pattern (kiem_tra_ket_noi, thong_ke_phong, dat_tham_so), though a few are noun-first (thong_tin_du_an, khoi_luong_tuong), a minor deviation that remains readable and predictable.
The server has 11 tools, which is well within the ideal 3-15 range for a Revit quantity-takeoff and parameter-management assistant. Each tool covers a distinct task and none appears redundant or trivial.
The surface covers connection check, project metadata, room/area stats, quantity extraction for major building elements, parameter auditing, parameter editing, and Excel export, which is comprehensive for a takeoff workflow. Minor gaps exist, such as no generic tool to read parameter values or list available parameters for a category.