andyluu98/vn-mcp-blender

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

11 stars 15 forks 품질 81 트렌드 32MIT

MCP server giúp AI dựng mô hình nhà 3D trong Blender từ dữ liệu kiến trúc Việt Nam: tường, sàn, cột, dầm, cầu thang, mái. Đọc mặt bằng DXF từ AutoCAD và bóc khối lượng từ chính mô hình.

개요

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. Tổng cộng 30 công cụ. Danh sách đầy đủ ở docs/cong-cu.md. 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. - 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 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 , tích vào ô bên trái để bật 3. Trong khung nhìn 3D, bấm phím để mở thanh bên 4. Chọn tab , bấm Khởi động lại Claude, rồi thử bảo: "kiểm tra kết nối Blender".

README

원문 README의 일부입니다. 원문 보기.

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.

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:

Edit > Preferences > Add-ons
Tì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.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    MCP server    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

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "vn-blender": {
      "command": "vn-mcp-blender"
    }
  }
}