VN MCP Blender
Reads AutoCAD DXF floor plans to extract wall centerlines and column positions for generating 3D models.
Enables AI to build 3D house models in Blender, including walls, floors, columns, beams, stairs, roofs, and door/window openings; supports applying materials, rendering previews, exporting to glb/fbx/obj/stl, and performing quantity takeoff from the model geometry.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@VN MCP Blender Dựng nhà phố 5x14m, 1 tầng, tường 220, 4 cột góc, render cho tôi xem."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VN MCP Blender
MCP server giúp AI dựng mô hình nhà 3D trong Blender từ dữ liệu kiến trúc, đọc được mặt bằng DXF từ AutoCAD và bóc khối lượng từ chính mô hình.
Viết riêng cho hồ sơ nhà ở Việt Nam: tường 220 và 110, cột bê tông, dầm, sàn, cầu thang, mái bằng. Mọi số đo tính bằng mét.
Làm được gì
Nhóm | Nội dung |
Dựng cấu kiện | Tường, sàn, cột, dầm, cầu thang, mái, khoét lỗ cửa |
Đọc bản vẽ | Nhập mặt bằng DXF, rút trục tim tường và vị trí cột |
Vật liệu | 10 vật liệu xây dựng dựng sẵn: bê tông, gạch, kính, gỗ, thép, ngói |
Nhìn và render | Chụp khung nhìn để kiểm tra, render ảnh phối cảnh |
Xuất | glb, fbx, obj, stl |
Bóc khối lượng | Đo thể tích từ hình học thật, đã trừ lỗ cửa |
Tổng cộng 30 công cụ. Danh sách đầy đủ ở docs/cong-cu.md.
Related MCP server: autocad-mcp
Cài đặt
Cần hai thứ: MCP server và addon trong Blender. Xem hướng dẫn từng bước ở docs/cai-dat.md, hoặc làm nhanh như dưới.
Yêu cầu
Blender 3.0 trở lên
Python 3.10 trở lên
Claude Code, Claude Desktop, hoặc bất kỳ ứng dụng nào nối được MCP
Bước 1: cài gói
git clone https://github.com/andyluu98/vn-mcp-blender
cd vn-mcp-blender
pip install -e .Bước 2: cài addon vào Blender
vn-mcp-blender install-addonLệnh này tự tìm Blender trên máy và chép addon vào. Sau đó trong Blender:
Edit > Preferences > Add-onsTìm MCP Xây Dựng, tích vào ô bên trái để bật
Trong khung nhìn 3D, bấm phím N để mở thanh bên
Chọn tab MCP Xây Dựng, bấm Bật kết nối
Bước 3: khai báo với Claude
Thêm vào file cấu hình MCP:
{
"mcpServers": {
"vn-blender": {
"command": "vn-mcp-blender"
}
}
}File cấu hình nằm ở:
Ứng dụng | Đường dẫn |
Claude Code |
|
Claude Desktop (Windows) |
|
Claude Desktop (macOS) |
|
Khởi động lại Claude, rồi thử bảo: "kiểm tra kết nối Blender".
Kiểm tra nhanh không cần Claude
vn-mcp-blender checkDùng thử
Mở Blender, bật addon, rồi bảo Claude:
Dựng cho tôi nhà phố 5m x 14m, 1 tầng, tường bao 220 cao 3.1m, sàn dày 100, 4 cột 220x220 ở bốn góc. Xong thì cho tôi xem ảnh.
Hoặc dựng từ bản vẽ có sẵn:
Đọc file F:/ban-ve/mat-bang.dxf xem có layer gì, rồi dựng tường lên 3D.
Trong thư mục examples/ có sẵn mô tả một căn nhà phố 5x20m, 3 tầng 1 tum lấy từ hồ sơ thật. Dựng thử bằng:
blender --background --python scripts/dung-vi-du.pyKiến trúc
Blender không nói chuyện MCP trực tiếp được, nên bộ này chia hai nửa:
Claude <--stdio/MCP--> MCP server <--socket TCP 9877--> Addon trong BlenderMCP server khai báo công cụ và đọc file DXF. Addon làm mọi việc dựng hình bằng thư viện bpy. Chi tiết ở docs/kien-truc.md.
Cổng mặc định là 9877, chọn khác 9876 để không đâm vào addon blender-mcp
phổ biến nếu bạn đang dùng cả hai.
Phát triển
pip install -e ".[dev]"
pytest50 test chạy được mà không cần mở Blender. Riêng phần hình học có script tự kiểm tra chạy trong Blender thật:
blender --background --python scripts/tu-kiem-tra.pyCách thêm công cụ mới: docs/phat-trien.md.
An toàn
Công cụ chay_python cho phép chạy Python bất kỳ trong Blender. Code được soát
trước để chặn xóa file, chạy lệnh hệ thống, và các thao tác làm mất bản vẽ đang
mở. Xem src/vn_mcp_blender/safe_mode.py.
Bộ soát này chặn lỗi rõ ràng, không phải tường lửa. Vẫn nên đọc code trước khi cho chạy trên bản vẽ quan trọng, và lưu file trước khi làm việc lớn.
Bộ công cụ này không gửi dữ liệu đi đâu. Không có telemetry.
Ghi chú về ngôn ngữ
Tài liệu và chữ hiện trên giao diện viết tiếng Việt có dấu. Riêng chú thích trong mã nguồn viết không dấu, để chạy được trên mọi máy không phụ thuộc bảng mã, kể cả khi Blender dùng bản Python cũ hoặc hệ điều hành đặt locale lạ.
Giấy phép
MIT. Xem LICENSE.
Dự án độc lập, không liên quan đến Blender Foundation.
Available Tools
30 toolsanh_sang_moi_truongB
Dat anh sang moi truong, dong vai bau troi hat sang vao cong trinh.
Chi co mot nguon SUN thi moi mat quay khoi huong nang deu den si, nhin khong ra hinh khoi. Goi tool nay cung voi tao_den de anh ro rang.
cuong_do: 0.5 cho troi chieu nang gat, 1.0 cho troi quang, 2.0 cho troi nhieu may hoac muon nhin ro moi chi tiet.
Inputs: mau, cuong_do.
boc_khoi_luongA
Boc khoi luong tu chinh mo hinh 3D da dung.
The tich do truc tiep tu hinh hoc nen da tru san cac lo cua da khoet. Ket qua gom tung loai cau kien va tong betong, tong khoi xay.
Inputs: no named parameters.
cai_dat_renderB
Dat do phan giai va engine render.
engine thuong dung: BLENDER_EEVEE_NEXT cho nhanh, CYCLES cho dep. Ten engine khac nhau giua cac ban Blender, neu sai thi thong bao loi se liet ke cac ten hop le.
Inputs: cao, rong, engine, mau_anh.
chay_pythonA
Chay Python bat ky ben trong Blender, dung khi khong co tool san phu hop.
Code duoc soat truoc de chan cac thao tac nguy hiem nhu xoa file hay chay lenh he thong. Gan gia tri vao bien ten 'ket_qua' de nhan lai gia tri do.
Luu y khi viet code chay tren may nguoi khac:
Tim node shader theo thuoc tinh type, khong theo ten, vi ten doi theo ngon ngu giao dien.
Khong viet cung ten enum, hay doc danh sach hop le tu bl_rna truoc.
Inputs: code (required).
doc_layer_dxfA
Liet ke layer trong mot file DXF, de biet layer nao chua tuong va cot.
Goi tool nay truoc khi dung dung_nha_tu_dxf, vi moi don vi thiet ke dat ten layer mot kieu.
Inputs: duong_dan (required).
doc_mat_bang_dxfA
Doc mat bang DXF va tra ve danh sach tuong, cot, chua dung gi trong Blender.
Dung tool nay de kiem tra du lieu doc ra co dung khong truoc khi dung. vung: [x0, y0, x1, y1] theo don vi ban ve, de lay rieng mot mat bang khi ho so xep nhieu mat bang canh nhau. ty_le: 0.001 cho ban ve milimet, 1.0 cho ban ve met.
Inputs: duong_dan (required), goc, vung, ty_le, +2 more.
dung_cau_thangC
Dung cau thang betong mot ve: ban nghieng cong cac bac nam tren.
huong_do: huong di len tinh bang do, 0 la theo truc X duong, 90 la truc Y duong. cao_bac nhan so_bac phai bang chieu cao tang. Vi du tang cao 3.15m thi 18 bac moi bac 0.175m. day_ban: be day ban thang, do vuong goc voi mat nghieng.
Thang duoc dung dung cau tao that chu khong dap mot khoi dac, nho vay khoi luong betong boc ra dung voi thuc te.
Inputs: diem_dau (required), ten, cao_do, so_bac, +5 more.
dung_cotC
Dung mot cot chu nhat. vi_tri la [x, y] tam cot.
Inputs: vi_tri (required), cao, sau, ten, +2 more.
dung_damC
Dung mot dam ngang. cao_do_day la cao do day dam, khong phai dinh dam.
Inputs: diem_dau (required), diem_cuoi (required), cao, ten, +2 more.
dung_maiC
Dung mai betong.
kieu: 'bang' cho mai bang co doc thoat nuoc, 'doc' cho mai mot doc. do_doc: ty le doc, 0.02 la 2 phan tram. vuon: phan mai dua ra ngoai mep tuong.
Inputs: dinh (required), day, ten, kieu, +3 more.
dung_nha_tu_dxfB
Doc mat bang DXF roi dung thang tuong va cot trong Blender.
Day la buoc noi giua ban ve 2D va mo hinh 3D. Nen goi doc_mat_bang_dxf truoc de kiem tra so lieu, roi moi goi tool nay.
Inputs: duong_dan (required), goc, vung, ty_le, +5 more.
dung_sanB
Dung tam san betong tu da giac mat bang.
dinh: danh sach [x, y] theo thu tu vong quanh, it nhat 3 diem. cao_do: cao do mat tren cua san. San do xuong duoi cao do nay.
Inputs: dinh (required), day, ten, cao_do.
dung_tu_mo_taA
Dung ca cong trinh tu mot ban mo ta, nhanh hon goi tung tool.
Day la cach nen dung khi dung nguyen mot ngoi nha. Cau truc mo_ta:
{
"ten": "Nha pho 5x20",
"tang": [
{
"ten": "Tang 1",
"cao_do": 0.0,
"cao_tuong": 3.1,
"san": {"dinh": [[0,0],[5,0],[5,14],[0,14]], "day": 0.1},
"tuong": [{"diem_dau": [0,0], "diem_cuoi": [5,0], "day": 0.22}],
"cot": [{"vi_tri": [0,0], "rong": 0.22, "sau": 0.22, "cao": 3.1}],
"cua": [{"tuong": 0, "khoang_cach": 1.0, "rong": 1.0,
"cao": 2.2, "be_cua": 0.0}]
}
]
}Truong "tuong" trong moi muc cua la so thu tu cua buc tuong trong danh sach tuong cua chinh tang do, dem tu 0.
Inputs: mo_ta (required).
dung_tuongB
Dung mot buc tuong thang tren mat bang.
diem_dau, diem_cuoi: [x, y] hai dau truc tim tuong, don vi met. day: be day tuong. Tuong bao 0.22, tuong ngan 0.11. cao: chieu cao tuong, thuong bang chieu cao tang tru chieu cao dam. cao_do: cao do chan tuong.
Inputs: diem_dau (required), diem_cuoi (required), cao, day, +2 more.
gan_vat_lieuC
Gan mot vat lieu da tao len doi tuong.
Inputs: ten_vat_lieu (required), ten_doi_tuong (required).
huong_danA
Doc huong dan nghiep vu truoc khi lam mot mang viec.
Bo trong de xem danh sach chu de co san.
Inputs: chu_de. Returns: result
khoet_cuaB
Khoet lo cua di hoac cua so tren mot buc tuong da dung.
ten_tuong: ten object tuong, lay tu ket qua dung_tuong. khoang_cach: tu diem dau cua tuong den mep trai lo cua. be_cua: cao do day lo so voi chan tuong. Cua di dat 0, cua so thuong 0.9.
Inputs: cao (required), rong (required), ten_tuong (required), khoang_cach (required), +1 more.
kiem_tra_ket_noiA
Kiem tra MCP server co noi duoc toi Blender khong.
Goi tool nay dau tien. Neu loi, thong bao se chi ro cach bat addon.
Inputs: no named parameters.
nhan_banC
Nhan ban mot doi tuong va doi di mot khoang. lech la [dx, dy, dz] bang met.
Inputs: ten (required), lech (required), ten_moi.
nhinB
Chup khung nhin Blender de nhin tan mat ket qua vua dung.
Goi tool nay sau moi buoc dung dang ke. Nhin anh roi tu danh gia: co khoi nao bay lo lung, dam xuyen qua nhau, hay sai ty le khong.
Inputs: kich_thuoc_toi_da.
render_anhB
Render anh chinh thuc bang engine dang chon.
Cham hon nhin nhung cho ra anh dep. Truyen duong_dan de luu lai file.
Inputs: duong_dan, kich_thuoc_toi_da.
sua_doi_tuongC
Doi vi tri, goc xoay, ty le hoac ten cua mot doi tuong. Goc tinh bang do.
Inputs: ten (required), ty_le, vi_tri, ten_moi, +1 more.
tao_cameraC
Dat camera va huong no vao mot diem.
tieu_cu 35 cho phoi canh rong, 50 cho goc nhin gan voi mat nguoi.
Inputs: vi_tri (required), ten, tieu_cu, nhin_vao, +1 more.
tao_denC
Tao nguon sang. kieu: SUN, POINT, SPOT hoac AREA.
SUN dung lam anh nang mat troi, goc_do quyet dinh huong nang.
Inputs: ten, kieu, goc_do, vi_tri, +1 more.
tao_vat_lieuC
Tao vat lieu xay dung.
loai co san: be_tong, gach, tuong_son, kinh, go, thep, ngoi, gach_lat, da, nhom. Truyen mau [r, g, b] trong khoang 0 den 1 de doi mau rieng.
Inputs: ten (required), mau, loai.
xem_canhC
Liet ke cac doi tuong dang co trong canh Blender.
chi_cua_addon: chi liet ke nhung thu bo cong cu nay dung ra.
Inputs: gioi_han, chi_cua_addon.
xem_doi_tuongB
Xem chi tiet mot doi tuong: vi tri, kich thuoc, vat lieu, so do cau kien.
Inputs: ten (required).
xoa_doi_tuongC
Xoa mot doi tuong khoi canh.
Inputs: ten (required).
xoa_toan_boA
Xoa cac doi tuong bo cong cu nay da dung.
Mac dinh chi xoa trong collection rieng, khong dung toi vat nguoi dung tu lam. Dat chi_cua_addon=False de xoa sach ca canh, can nhac ky truoc khi dung.
Inputs: chi_cua_addon.
xuat_fileC
Xuat mo hinh ra file. dinh_dang: glb, fbx, obj hoac stl.
glb hop de xem tren web va dien thoai, fbx hop de dua sang phan mem khac.
Inputs: duong_dan (required), dinh_dang, chi_cua_addon.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 30 tools
Most tools target clearly distinct resources/actions, and descriptions explicitly disambiguate the tricky pairs (doc_mat_bang_dxf reads vs dung_nha_tu_dxf builds; nhin takes a viewport screenshot vs render_anh does a final render; tao_den adds a light vs anh_sang_moi_truong sets world lighting). The only mild overlap is between the high-level dung_tu_mo_ta / dung_nha_tu_dxf and the individual dung_* primitives, but the abstraction levels are well explained.
Every name is Vietnamese snake_case with a consistent verb prefix tied to intent: dung_ (build), xem_ (view), doc_ (read), tao_ (create), xoa_ (delete). The pattern is predictable and readable throughout.
30 tools is on the heavy side, though the domain genuinely spans modeling primitives, DXF import, materials, lighting, rendering, export, and quantity takeoff. Each tool earns its place, but the surface is large enough to feel burdensome for an agent.
The surface covers a full architectural workflow: build primitives, inspect, modify, duplicate, delete, cut openings, materials, lights, camera, render, export, DXF ingestion, and quantity takeoff. Minor gaps exist (e.g. grouping/parenting or post-build wall editing), but core lifecycle coverage is strong.
Related MCP Connectors
Read, query, edit and render DWG drawings with AI. No AutoCAD required.
Design buildings as IFC4 BIM models from a brief: an AI architect that plans, builds and edits.
AI takeoff for construction: turn PDF blueprints into structured, traceable quantities.
AI Hub for AEC — 50+ 3D formats, clash detection, ACC integration via Autodesk Platform Services.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI assistants to create, edit, and export IFC5/IFCX building information models through natural language, handling spatial structure, elements, geometry, metadata, validation, and export.7326MIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude AI to AutoCAD for architectural design, enabling natural language to execute 684 commands. Automates drawing creation and editing through the Model Context Protocol.43 npm9MIT
- FlicenseNot gradedqualityAmaintenanceAI-powered control of Autodesk Revit through the Model Context Protocol, enabling natural language BIM workflows.111-
- AlicenseAqualityCmaintenanceEnables AI-driven 3D modeling and scene creation in Blender, allowing LLMs to create, modify, and manipulate objects, materials, and assets through natural language.31MIT