blender-mcp-master
This is a read-only resource server that serves Blender MCP Master skill content and planning guidance; it does not control a live Blender session.
Retrieve the main
SKILL.mdagent instructions.List and read bundled modeling reference guides.
Get reference outlines and bounded excerpts for low-context reading.
Retrieve reusable Blender Python scripts by filename.
Explain how the skill relates to a separate Blender-control MCP server.
Recommend minimal guides and unanswered design topics for a Blender workflow without touching Blender.
Supports Blender 3D asset workflows with skill instructions, reference guides, and reusable bpy script templates for validation, mesh cleanup, LOD generation, PBR materials, scene setup, and game-ready export; live scene editing is performed through a separate Blender-control MCP server.
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., "@blender-mcp-master get the blender modeling skill and the export reference guide"
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.
Blender MCP Master
Better decisions. Better meshes.
Blender MCP Master helps AI agents plan, model, inspect, and validate Blender assets using task-specific instructions, scripts, and evidence-based quality checks.
Important: This skill does not control Blender by itself. Live editing needs a separate Blender-control MCP server and Blender addon. The optional MCP resource server here is read-only.
Blender MCP Master 2.0: seven reusable specialist modules, executable host-adapter orchestration, independent QA handoffs, hashed evidence receipts and default dry-run. A concrete Codex CLI worker handles read-only reviews; the bundled native bpy host supplies checkpoints, scene probes, writer leases and dispatch of explicitly inspected production callbacks. Execution contract · Implementation and Agency Agents references · Validation record. See the 2.0 release notes for migration and the scope of verified behavior.
Define | Build | Inspect | Deliver |
Establish style, purpose, proportions, and constraints. | Block out primary forms, then refine in reversible stages. | Verify actual mesh data and visual references. | Disclose measured results and what remains unverified. |
Get started
1. Install the stable skill
Download v2.0.0 · Installable ZIP
Get SHA256SUMS.txt from the same release, verify the hash, extract the ZIP and copy its inner blender-mcp-master folder to your agent's skills directory. Full Windows and agent setup instructions.
With a current Skills CLI, pin the same release tag:
npx skills add God-601/blender-mcp-master@v2.0.0 --skill blender-mcp-master -g2. Set up Blender control separately
Connect a compatible Blender-control MCP and its addon; discover the actual tool names and Blender version. Start in a scratch or backed-up scene. The skill supplies guidance, not a live Blender connection.
Start the optional read-only MCP resource server from the stable GitHub tag:
npx -y "github:God-601/blender-mcp-master#v2.0.0"Configure Blender scene control separately.
The skill adapts its design questions to the brief, plans modeling by task, and checks evaluated geometry, scene preservation, UVs, materials and game-asset budgets. The quality toolkit includes conservative component-fit and containment diagnostics, PNG silhouette measurements, PBR channel inspection, and evidence-backed specialist review reports.
Verified in CI: Blender bpy regression suites, a real Cycles texture-bake fixture, and Blender-authored GLB import in Godot 4.4.1. User-reported Roblox Studio acceptance: Sofa V3 LOD meshes and PBR maps were inspected and the user approved the visible result. This does not certify universal Roblox/Unity compatibility or artistic quality.
See the v2.0.0 release notes, game export guidance, and the v1.5–1.9 milestone status.
Related MCP server: blender-unified
Workflow
USER BRIEF + REFERENCE
|
v
BLENDER MCP MASTER [Agent Skill]
Clarify -> Plan -> Blockout -> Refine -> Verify
| ^
v |
BLENDER-CONTROL MCP ------------------+
|
Blender sceneThe agent must inspect before it claims success. Geometry checks, screenshots, and target-format checks answer different questions; missing evidence is NOT VERIFIED, not a pass.
Focus | What changes |
Scene safety | Explicit targets, owned collections, backup-first changes |
Modeling quality | Proportion checks before unnecessary micro-detail |
Technical validity | Evaluated topology, modifiers, UVs, materials, and budgets |
Visual validation | Real viewport views before judging appearance |
Delivery |
|
Supported workflows include hard-surface props, organic modeling, stylized and low-poly assets, architecture, environments, characters, UV/baking, materials, and game-ready exports. Available features depend on the actual Blender installation and connected MCP tools.
Documentation
Resource | Purpose |
Installation, Windows paths, checksums, and MCP setup | |
Main instruction entrypoint for agents | |
Curated modeling, modifiers, UV, Geometry Nodes, Python API, export references | |
Stage gates, independent review, defect diagnosis, and stop conditions | |
Production requirements and quality evidence | |
Concrete modeling examples | |
Reference patterns, including Superpowers | |
Production architecture, staged acceptance gates and remaining validation | |
Candidate capabilities and open acceptance gates | |
Read-only MeshPart/PBR/LOD inspection procedure | |
Executable import probe, scope and limitations | |
Tool-first, bounded reads and progressive context loading | |
Evaluated triangle, material, texture and Geometry Nodes guidance | |
Reproducible with/without skill comparison protocol |
python -m unittest discover -s tests -vSome tests require a compatible bpy runtime. Passing tests is not proof of artistic quality or live MCP and downstream export compatibility.
Milestones v1.5–1.9 · Roadmap v2.0 and pre-release audit · Quality checklist · Changelog · Contributing
Português
Uma skill para agentes de IA modelarem no Blender com método e evidências. Ajuda a planejar, modelar, verificar topologia, UVs, materiais PBR e preparar assets para jogos. Ela orienta o agente; não instala nem substitui o Blender-control MCP.
Instale a v2.0.0 pelo ZIP da release ou com
npx skills add God-601/blender-mcp-master@v2.0.0 --skill blender-mcp-master -g.Servidor de recursos opcional de somente leitura via
npx -y "github:God-601/blender-mcp-master#v2.0.0".Configurar: conectar separadamente um Blender-control MCP. Veja o guia para Windows e agentes.
Fluxo: esclarecer → planejar → modelar → inspecionar → corrigir → relatar o que foi verificado.
Aprofundar: documentação oficial · verificação e recuperação · padrões profissionais.
Inclui verificações técnicas e exemplos reais de baking e importação no Godot. Um sofá com três LODs e mapas PBR foi aprovado pelo usuário em uma campanha anterior no Roblox Studio.
A 2.0 reúne módulos especializados, executor por adaptador do cliente, um escritor por vez, QA independente e recibos com SHA256. Tarefas simples ficam com o coordenador. O adaptador deve fornecer as ferramentas reais do Blender; a ponte de revisão Codex é somente leitura. Contrato e uso · Evidências e pendências.
Available Tools
8 toolsget_blender_mcp_setupBRead-only
Explain how this skill/resource server relates to a separate MCP server that controls a live Blender session.
Inputs: no named parameters.
get_blender_referenceARead-only
Read one bundled modeling reference guide by exact filename.
Inputs: name (required).
get_blender_reference_excerptARead-only
Read only a bounded line window from a reference. Returns continuation line; use before requesting full text.
Inputs: name (required), startLine (required), maxLines.
get_blender_reference_outlineARead-only
List only section headings and their line numbers from one guide. Low-context alternative to reading the full document.
Inputs: name (required).
get_blender_scriptARead-only
Return one reusable Blender Python script by exact filename. Review its configuration and safety notes before execution.
Inputs: name (required).
get_blender_skillBRead-only
Return the Blender MCP Master agent skill instructions (SKILL.md).
Inputs: no named parameters.
list_blender_resourcesARead-only
List the skill reference guides and reusable Blender Python scripts bundled with this package.
Inputs: no named parameters.
plan_blender_workflowCRead-only
Recommend minimal on-demand guides and unanswered design topics without touching Blender.
Inputs: category (required), known, needs, delegated, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a distinct role: skill instructions, resource listing, reference reading, outline, excerpt, script retrieval, setup explanation, and workflow planning. The three reference-reading tools (get_blender_reference, get_blender_reference_outline, get_blender_reference_excerpt) operate on the same documents at different granularities, which could cause some misselection, but the descriptions clearly delineate low-context vs. bounded-window vs. full-read use cases.
All tools follow a uniform snake_case verb_noun pattern scoped by the domain (get_blender_*, list_blender_*, plan_blender_workflow). No mixed conventions or abbreviation drift, making intent predictable from the name alone.
Eight tools is well-scoped for a read-only skill/resource server with no redundancy. Every tool maps to a distinct access pattern (metadata, full read, outline, excerpt, script, setup, planning) and none feels padded.
The read-only resource surface is largely complete: discovery, granular reading, scripts, setup context, and planning are all covered. The main gap is a search/lookup tool to find which reference covers a topic without first listing files; otherwise no dead ends for the stated purpose.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Remote MCP server exposing SMI Aware tools, resources, and skills over Streamable HTTP.
MCP server (stdio): validate JSON against JSON Schema (draft-07 / 2020-12) via the AgentForge API
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceServes skill-defined JSON-in/JSON-out scripts as callable tools over MCP stdio, driven by a portable skill-runtime.json manifest that supplies each tool's title, description, and input schema. Exposes commands to validate, list, and run skills, so hosts can discover and invoke agent skills without custom per-skill glue code.8 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible clients to control Blender for modeling, materials, animation, physics, rendering, scene inspection, documentation search, and asset/generation service integration. It exposes a stdio endpoint with many Blender operations for creating and editing 3D content.AGPL 3.0
- AlicenseAqualityBmaintenanceEnables MCP hosts to list and render bundled prompt templates and fetch assistant blueprints for ChatGPT, Claude, Gemini, Grok, or portable Agent Skill format. Operates locally over stdio with read-only tools and no network, shell, account, or file-write access.346 PyPI1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to drive a live Blender session over stdio, inspecting the scene graph, searching and calling operators, reading and writing RNA properties, rendering viewable images, and checkpointing or restoring the file across a multi-turn conversation. It also exposes gallery and scene-reset helpers so the agent can check its own work and start over cleanly.19GPL 3.0