Skip to main content
Glama
VN MCP Blender
by andyluu98

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-addon

Lệnh này tự tìm Blender trên máy và chép addon vào. Sau đó trong Blender:

  1. Edit > Preferences > Add-ons

  2. Tìm MCP Xây Dựng, tích vào ô bên trái để bật

  3. Trong khung nhìn 3D, bấm phím N để mở thanh bên

  4. 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.json

Claude Desktop (Windows)

%APPDATA%\Claude\claude_desktop_config.json

Claude Desktop (macOS)

~/Library/Application Support/Claude/claude_desktop_config.json

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 check

Dù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.py

Kiế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 Blender

MCP 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]"
pytest

50 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.py

Cá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 tools
anh_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

    B3.3/5.0

    Scored across 30 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables AI assistants to create, edit, and export IFC5/IFCX building information models through natural language, handling spatial structure, elements, geometry, metadata, validation, and export.
      73
      26
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects 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 npm
      9
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      AI-powered control of Autodesk Revit through the Model Context Protocol, enabling natural language BIM workflows.
      111
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI-driven 3D modeling and scene creation in Blender, allowing LLMs to create, modify, and manipulate objects, materials, and assets through natural language.
      31
      MIT