mcp-for-blender: điều khiển Blender bằng AI — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về ahujasid/mcp-for-blender — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: mcp-for-blender: điều khiển Blender bằng AI — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
mcp-for-blender là plugin cộng đồng kết nối Blender với các ứng dụng AI hỗ trợ MCP. Bạn có thể yêu cầu AI tạo và chỉnh sửa vật thể, vật liệu, cảnh 3D hoặc chạy mã Python trong Blender. Cài đặt khá đơn giản nếu dùng uv và trình thiết lập tự động; Blender vẫn phải được cài riêng.
mcp-for-blender là plugin cộng đồng giúp bạn điều khiển Blender 3D bằng AI thông qua Model Context Protocol (MCP). Bạn có thể mô tả bằng ngôn ngữ tự nhiên, còn AI sẽ gửi lệnh đến Blender để tạo cảnh, dựng vật thể, chỉnh vật liệu hoặc chạy mã Python.
Repo phù hợp với người làm 3D, chủ shop cần dựng mẫu sản phẩm, nhân viên văn phòng muốn tạo hình minh họa, và lập trình viên mới muốn thử tự động hóa Blender. Điểm đáng giá nhất là AI có thể kiểm tra kết quả bằng nhiều góc nhìn, ảnh render, wireframe, X-ray và dải hoạt ảnh thay vì chỉ gửi lệnh một chiều.
Đây là tích hợp bên thứ ba, không phải sản phẩm của Blender Foundation. Hệ thống gồm một addon chạy bên trong Blender và một MCP server chạy bên ngoài. Repo có khoảng 34.269 sao và 3.117 fork, dùng giấy phép MIT.
ahujasid/mcp-for-blender
Plugin kết nối Blender với AI qua MCP để tạo, chỉnh sửa, kiểm tra cảnh 3D bằng ngôn ngữ tự nhiên.
I.mcp-for-blender làm được gì
A.Điều khiển Blender qua hội thoại
Bạn có thể yêu cầu AI tạo hoặc thay đổi cảnh 3D bằng câu mô tả thông thường. MCP server chuyển yêu cầu đến addon trong Blender qua socket server. Cách này giúp người chưa quen giao diện hoặc Python vẫn bắt đầu được với các tác vụ 3D cơ bản.
B.Tạo, sửa và xóa vật thể
AI có thể tạo vật thể mới, chỉnh sửa vật thể có sẵn và xóa những phần không cần thiết. Ví dụ, bạn có thể yêu cầu dựng một khối hộp, thay đổi kích thước, sắp xếp nhiều vật thể hoặc tạo một bố cục sản phẩm.
C.Điều khiển vật liệu và màu sắc
Repo hỗ trợ áp dụng và chỉnh sửa material, màu sắc trong Blender. Điều này hữu ích khi bạn muốn thử nhanh nhiều phiên bản màu cho bao bì, sản phẩm, mô hình nội thất hoặc cảnh minh họa.
D.Kiểm tra trực quan kết quả
AI có thể xem kết quả theo nhiều góc: camera, nhiều góc nhìn, wireframe, X-ray, ảnh render và animation strip. Nhờ vậy, AI có cơ hội phát hiện vật thể bị đặt sai, hình học chưa đúng hoặc cảnh chưa giống mô tả.
E.Chạy mã Python trong Blender
AI có thể viết và thực thi trực tiếp mã Python của Blender. Đây là khả năng mạnh cho các công việc lặp lại như tạo nhiều vật thể, đặt tên, sắp xếp theo quy tắc hoặc dựng cảnh theo tham số.
Mặc định, mã Python có thể thực hiện mọi thao tác mà Blender cho phép. Nếu cần hạn chế, bạn có thể bật safe mode để kiểm tra script trước khi chạy.
F.Tạo và nhập asset 3D
README đề cập đến asset từ Poly Haven, model từ Sketchfab và Poly Pizza. Repo cũng hỗ trợ tạo model 3D bằng Meshy, Tripo, Hyper3D Rodin và Hunyuan3D, cùng các thế giới Gaussian-splat từ World Labs.
Phần tạo model AI cao cấp và World Labs được giới thiệu trong gói Premium. README nói rằng bạn có thể dùng các dịch vụ này mà không cần tự cung cấp API key, nhưng không nêu đầy đủ chi tiết chi phí trong phần tư liệu được cung cấp.
G.Dùng với nhiều MCP client
Trình thiết lập có thể tìm các ứng dụng MCP trên máy, gồm Claude Desktop, Claude Code, Codex, Cursor, VS Code, Devin Desktop, Windsurf, OpenCode và Antigravity. Bạn chọn client muốn cấu hình, sau đó công cụ thêm một mục blender vào cấu hình hiện có.
II.Cần chuẩn bị gì
Bạn cần cài Blender phiên bản 3.0 trở lên. Addon được cài vào Blender và addon sẽ khởi động socket server khi Blender mở.
Bạn cần Python 3.10 trở lên. pyproject.toml của repo khai báo yêu cầu Python tối thiểu là 3.10. Với cách chạy được README khuyến nghị, bạn cũng cần uv, trong đó có lệnh uvx.
Bạn cần một MCP client tương thích, chẳng hạn Claude Desktop, Claude Code, Codex, Cursor, VS Code hoặc một client khác được README hỗ trợ. Tài khoản AI và quyền sử dụng client phụ thuộc vào ứng dụng bạn chọn; phần tư liệu không mô tả một tài khoản bắt buộc chung cho mọi client.
Bạn không cần tự khai báo API key cho phần kết nối cơ bản giữa AI và Blender. Các tính năng Premium được giới thiệu là có thể tạo model AI và thế giới trong Blender mà không cần tự mang API key, nhưng README được cung cấp chưa nói rõ điều kiện hoặc chi phí cụ thể.
Bạn cần mở Blender cùng lúc với MCP server để hai thành phần kết nối được. Addon mặc định dùng host localhost và port 9876.
Socket server của addon không có xác thực hoặc mã hóa. Giữ kết nối ở localhost khi có thể. Nếu mở trên mạng không tin cậy, người có thể truy cập port có khả năng chạy Python bên trong Blender.
III.Cài đặt từng bước
- Chuẩn bị Blender và uvCài Blender 3.0 trở lên cùng uv bằng trình cài chính thức
- Chạy trình thiết lậpĐể công cụ cài addon và cấu hình MCP client
- Cấu hình thủ công nếu cầnThêm server blender vào client và cài addon bằng uvx
- Bật addon trong BlenderKiểm tra addon trong Preferences và bật MCP server
- Khởi động lại ứng dụng AIĐóng hoàn toàn client rồi mở lại để nhận cấu hình
A.Chuẩn bị Blender và uv
Cài Blender 3.0 trở lên trước. Sau đó cài uv bằng trình cài chính thức. README cảnh báo không dùng pip install uv, vì cách này có thể không tạo được lệnh uvx hoặc đặt uv trong môi trường mà MCP client không nhìn thấy.
Trên macOS, mở Terminal và chạy:
brew install uvTrên Linux, chạy:
curl -LsSf https://astral.sh/uv/install.sh | shSau đó mở một shell mới để uv có trong PATH.
Trên Windows, mở PowerShell và chạy:
winget install --id=astral-sh.uv -eBạn cần mở một terminal mới sau khi cài. Nếu muốn dùng trình cài của uv trên Windows, chạy:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Người mới thường vấp ở chỗ đã cài uv nhưng ứng dụng AI mở từ Start menu vẫn không tìm thấy uvx. Ứng dụng mở từ giao diện có thể không kế thừa PATH của terminal. Khi gặp lỗi này, README hướng dẫn tìm đường dẫn đầy đủ bằng lệnh sau:
which uvxTrên Windows, dùng:
where uvxB.Chạy trình thiết lập tự động
Trên macOS hoặc Linux, chạy:
curl -LsSf https://www.mcp-for-blender.com/install.sh | shTrên Windows PowerShell, chạy:
irm https://www.mcp-for-blender.com/install.ps1 | iexNếu dùng Command Prompt, chạy:
powershell -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"Nếu không muốn chạy script hoặc Windows Defender chặn script, cài uv bằng winget, mở terminal mới rồi chạy:
winget install --id=astral-sh.uv -e
uvx mcp-for-blender setupNếu uv đã có sẵn, chỉ cần chạy:
uvx mcp-for-blender setupTrình thiết lập tìm các MCP client trên máy, cho bạn chọn client muốn cấu hình, cài addon Blender và bật addon. Cấu hình cũ được giữ lại. Công cụ chỉ thêm mục blender và lưu bản sao .bak của mỗi file đã thay đổi.
Đây là cách thuận tiện nhất nếu bạn mới làm quen. Sau khi chạy xong, hãy đóng hoàn toàn ứng dụng AI rồi mở lại. Trên Windows, cần thoát ứng dụng từ khay hệ thống, không chỉ đóng cửa sổ.
C.Cấu hình MCP client thủ công
Nếu cài tự động không thành công, trước hết chắc chắn uv đã được cài. Với Claude Desktop, mở phần Settings → Developer → Edit Config và thêm cấu hình:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}Với Claude Code, chạy:
claude mcp add blender uvx mcp-for-blenderVới Codex CLI, chạy:
codex mcp add blender -- uvx mcp-for-blenderHoặc thêm thủ công vào ~/.codex/config.toml:
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]Nếu client không tìm thấy uvx, thay giá trị command bằng đường dẫn đầy đủ của uvx. Trên Windows, README cũng nêu cách dùng:
{
"mcpServers": {
"blender": {
"command": "cmd",
"args": ["/c", "uvx", "mcp-for-blender"]
}
}
}Sau khi sửa PATH hoặc file cấu hình, phải thoát hoàn toàn rồi khởi động lại client.
D.Cài addon vào Blender
Chạy lệnh sau trong terminal:
uvx mcp-for-blender install-addonSau đó mở Blender, vào Edit → Preferences → Add-ons, tìm Interface: MCP for Blender và bật addon. Nếu addon chưa xuất hiện, kiểm tra lại terminal có chạy đúng uvx và lệnh cài có hoàn tất hay không.
E.Kết nối Blender với MCP server
Mở Blender và chuyển đến 3D Viewport. Nhấn N để mở sidebar, chọn tab MCP for Blender. Nếu server chưa chạy, nhấn Start MCP Server.
Addon sẽ tự khởi động server khi Blender mở. Bạn chỉ nên chạy một instance MCP server cho một kết nối, không chạy đồng thời từ Cursor và Claude Desktop cho cùng cấu hình.
F.Pin phiên bản Python khi gặp lỗi phụ thuộc
Nếu máy có conda, pyenv, asdf hoặc bản CPython mới khiến phụ thuộc chưa có wheel phù hợp, README khuyến nghị pin Python 3.11:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["--python", "3.11", "mcp-for-blender"],
"env": { "UV_PYTHON_PREFERENCE": "only-managed" }
}
}
}--python 3.11 vẫn đáp ứng yêu cầu Python từ 3.10 trở lên. Nếu lần cài lỗi trước đó vẫn bị lặp lại, xóa cache rồi làm mới gói:
uv cache clean mcp-for-blender blender-mcp && uvx --refresh mcp-for-blenderG.Cài bằng pipx hoặc Docker
Nếu máy bị giới hạn và không muốn dùng uvx, README cho phép dùng pipx:
pipx install mcp-for-blender
pipx ensurepathSau đó khởi động lại shell hoặc client, tìm đường dẫn lệnh mcp-for-blender bằng which mcp-for-blender hoặc where mcp-for-blender, rồi dùng đường dẫn đầy đủ làm command và bỏ args.
Bạn cũng có thể chạy server bằng Docker. Từ thư mục gốc repo, xây image:
docker build -t mcp-for-blender .Cấu hình client:
{
"mcpServers": {
"blender": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp-for-blender"]
}
}
}Cờ -i là bắt buộc vì server giao tiếp với client qua stdin/stdout. Blender vẫn chạy trên máy của bạn; container chỉ chạy MCP server. Trên macOS và Windows với Docker Desktop, image mặc định dùng host.docker.internal. Trên Linux, dùng host networking:
{
"mcpServers": {
"blender": {
"command": "docker",
"args": ["run", "-i", "--rm", "--network=host", "-e", "BLENDER_HOST=localhost", "mcp-for-blender"]
}
}
}IV.Kiểm tra đã chạy được chưa
Trong Blender, mở 3D Viewport, nhấn N, chọn tab MCP for Blender và kiểm tra server đang chạy. Nếu chưa chạy, nhấn Start MCP Server.
Với Codex CLI, kiểm tra server đã đăng ký bằng:
codex mcp listMục blender cần hiển thị trạng thái enabled. Sau khi khởi động lại Codex, các tool MCP sẽ sẵn sàng.
Cách kiểm tra thực tế đơn giản là gửi cho AI một yêu cầu nhỏ, chẳng hạn yêu cầu tạo một khối hộp trong Blender. Nếu AI có thể gửi lệnh và vật thể xuất hiện trong viewport, kết nối giữa client, MCP server và addon đã hoạt động.
Nếu client báo spawn uvx ENOENT, đây là dấu hiệu client không tìm thấy uvx, dù terminal có thể chạy được lệnh. Dùng đường dẫn đầy đủ của uvx, sửa cấu hình rồi thoát và mở lại client.
V.Dùng vào việc thật
A.Chủ shop dựng nhanh mẫu sản phẩm
Chủ shop có thể mở một file Blender mới và yêu cầu AI tạo một bố cục sản phẩm đơn giản: một hộp đặt trên mặt phẳng, camera ở góc ba phần tư, màu nền sáng và material theo màu thương hiệu. AI có thể tạo vật thể, đặt vật liệu và kiểm tra bằng camera hoặc render.
Prompt mẫu:
Tạo một cảnh giới thiệu sản phẩm gồm một hộp đứng trên mặt phẳng, đặt camera ở góc ba phần tư, dùng nền sáng và material màu xanh đậm cho hộp. Kiểm tra cảnh bằng camera và cho biết nếu hộp bị lệch khỏi khung hình.Kết quả mong đợi là một cảnh Blender có vật thể, vật liệu và góc nhìn được sắp xếp theo mô tả. Đây phù hợp cho bản phác thảo ban đầu, không thay thế quy trình thiết kế sản phẩm hoàn chỉnh.
B.Nhân viên văn phòng tạo hình minh họa
Nhân viên cần hình minh họa cho tài liệu nội bộ có thể yêu cầu tạo một cảnh 3D đơn giản, chẳng hạn bàn làm việc với vài vật thể, rồi nhờ AI đổi màu hoặc thay đổi bố cục. Khả năng điều khiển bằng câu chữ giúp người không quen thao tác 3D thử nhiều phương án nhanh hơn.
Prompt mẫu:
Tạo một cảnh bàn làm việc tối giản gồm mặt bàn, ghế, màn hình và đèn. Đặt các vật thể gọn trong camera, dùng màu trung tính và kiểm tra thêm bằng wireframe.AI có thể dùng mã Python Blender để tạo các vật thể và sắp xếp chúng. Bạn nên lưu phiên bản trước khi yêu cầu các thay đổi lớn.
C.Dev tự động hóa cảnh 3D lặp lại
Lập trình viên có thể yêu cầu AI viết mã Python để tạo nhiều vật thể theo quy tắc, đổi tên, chỉnh kích thước hoặc sắp xếp chúng theo hàng. Đây là trường hợp MCP for Blender có giá trị rõ rệt vì AI không chỉ thao tác thủ công mà còn chạy được code trong Blender.
Prompt mẫu:
Dùng Python trong Blender để tạo một lưới gồm các khối hộp cách đều nhau, đặt tên theo hàng và cột, sau đó kiểm tra bằng góc nhìn camera.Vì mã Python có quyền cao trong Blender, hãy xem lại yêu cầu trước khi cho AI chạy trên file quan trọng. Có thể bật BLENDER_MCP_SAFE_MODE=1 để kiểm tra script trước khi thực thi.
D.Người làm 3D thử asset và model AI
Người dựng cảnh có thể yêu cầu AI tìm hoặc đưa asset từ Poly Haven, Sketchfab hay Poly Pizza vào quy trình Blender, hoặc dùng các dịch vụ được README liệt kê như Meshy, Tripo, Hyper3D Rodin và Hunyuan3D để tạo model AI. README cũng nêu khả năng đưa thế giới Gaussian-splat từ World Labs vào Blender.
Prompt mẫu:
Tạo một cảnh thử nghiệm với asset low-poly phù hợp, đặt các vật thể thành một bố cục có thể kiểm tra trong viewport và cho tôi xem các góc nhìn khác nhau.Khả năng cụ thể phụ thuộc client, dịch vụ và phần Premium. Nếu mục tiêu là sản phẩm thương mại, bạn vẫn cần kiểm tra giấy phép asset và chất lượng model trước khi sử dụng.
Từ một câu mô tả, bạn có thể đi thẳng đến một cảnh 3D có thể nhìn, kiểm tra và chỉnh sửa.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Client báo không tìm thấy uvx
Lỗi thường có dạng spawn uvx ENOENT. Nguyên nhân là ứng dụng mở từ giao diện không nhận PATH của terminal. Chạy which uvx trên macOS/Linux hoặc where uvx trên Windows, sau đó dùng đường dẫn đầy đủ làm command. Thoát hoàn toàn client rồi mở lại.
B.Cài uv bằng pip nhưng không có uvx
README khuyến cáo không dùng pip install uv. Cách này có thể làm uvx không xuất hiện hoặc bị đặt trong môi trường mà client không nhìn thấy. Cài lại bằng brew, winget hoặc trình cài chính thức của uv.
C.Blender mở nhưng AI không kết nối
Kiểm tra addon Interface: MCP for Blender đã được bật trong Edit → Preferences → Add-ons chưa. Trong 3D Viewport, nhấn N, mở tab MCP for Blender và nhấn Start MCP Server nếu cần. Cũng kiểm tra bạn không chạy đồng thời nhiều MCP server cho cùng kết nối.
D.Phụ thuộc Python cài thất bại
Máy có conda, pyenv hoặc asdf có thể khiến uv chọn sai Python. Thử cấu hình --python 3.11 cùng UV_PYTHON_PREFERENCE=only-managed. Nếu lỗi cũ vẫn được dùng lại, chạy lệnh xóa cache và refresh gói được README cung cấp.
E.Dùng Docker nhưng server không giao tiếp
Kiểm tra container có cờ -i, vì MCP server dùng stdin/stdout. Trên Linux, host.docker.internal không tồn tại theo README; dùng --network=host và BLENDER_HOST=localhost. Blender vẫn phải chạy trên máy host và addon phải đang lắng nghe.
VII.Có nên dùng không
Nên dùng nếu bạn muốn điều khiển Blender bằng AI, cần tạo nhanh cảnh 3D, muốn thử tự động hóa bằng Python hoặc đã dùng Claude, Codex, Cursor và các MCP client tương thích. Việc cài đặt có đường tự động, có cấu hình thủ công, có lựa chọn pipx và Docker. Repo dùng MIT và vẫn được cập nhật.
Điểm mạnh là kết nối hai chiều, hỗ trợ nhiều client, có kiểm tra trực quan, chạy được Python Blender và có nhiều hướng xử lý asset. Người mới cũng có thể bắt đầu bằng vài câu mô tả thay vì học toàn bộ giao diện Blender ngay từ đầu.
Giới hạn quan trọng là đây không phải công cụ chính thức của Blender Foundation. Socket server không có xác thực hoặc mã hóa. Mặc định AI có thể chạy mọi Python code trong Blender, nên không nên mở port ra mạng không tin cậy. Safe mode giúp kiểm tra các thao tác nguy hiểm, nhưng bạn vẫn cần kiểm tra yêu cầu trước khi chạy trên file quan trọng.
Bạn cũng cần Blender chạy trên máy và phải xử lý vấn đề PATH của uvx nếu client khởi động từ giao diện. Các tính năng model AI và World Labs thuộc phần Premium; tư liệu được cung cấp chưa đủ để kết luận chi phí hoặc điều kiện sử dụng cụ thể. Nếu bạn chỉ cần dựng 3D thủ công, không muốn dùng AI hoặc cần một quy trình kiểm soát tuyệt đối từng thao tác, dùng Blender trực tiếp có thể phù hợp hơn.
Câu hỏi thường gặp
mcp-for-blender là gì?
Đây là plugin cộng đồng kết nối Blender với các ứng dụng AI hỗ trợ MCP. AI có thể tạo, chỉnh sửa, xóa vật thể, điều khiển vật liệu và chạy Python trong Blender.
Có chạy được trên Windows không?
Có. README có hướng dẫn PowerShell, winget và cấu hình Docker Desktop trên Windows. Bạn cần Blender 3.0 trở lên, Python 3.10 trở lên và uv.
Có cần GPU không?
Tư liệu được cung cấp không nói rằng phải có GPU riêng. README chỉ nêu yêu cầu Blender, Python, uv và MCP client.
Có miễn phí không?
Repo dùng giấy phép MIT. README có phần Premium cho việc tạo model 3D AI và thế giới World Labs, nhưng tư liệu được cung cấp chưa nêu chi tiết chi phí.
Dữ liệu và Blender có an toàn không?
Socket server của addon không có xác thực hoặc mã hóa, và mặc định AI có thể chạy Python trong Blender. Nên giữ kết nối ở localhost, dùng safe mode khi phù hợp và tránh mở port trên mạng không tin cậy.
Có cần tự cung cấp API key không?
Kết nối cơ bản với Blender không yêu cầu API key riêng trong hướng dẫn. README nói các tính năng Premium có thể dùng model AI và World Labs mà không cần tự mang API key, nhưng chưa nêu đầy đủ điều kiện.
Có thể chạy nhiều Blender cùng lúc không?
Có thể cấu hình các instance bằng port khác nhau. README nêu ví dụ dùng `--port 9877`, và mỗi instance cần đặt port tương ứng trong panel addon.


