Blender MCP Server
Controls Blender through a local HTTP bridge, providing tools for scene inspection, animation, modeling, and export to glTF.
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 Server List all objects in the scene"
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 Server
MCP server for Cursor that controls Blender through a local HTTP bridge.bpy runs inside Blender — this repo does not import bpy in the MCP process.
Separate from Summit — export .glb files to Summit's Assets/ when ready.
Architecture
Cursor Agent → MCP (this repo) → HTTP bridge → bpy → BlenderPath | Role |
| MCP entry (stdio) |
| Tools exposed to the agent |
| Blender addon (HTTP + bpy commands) |
| Bridge port, Summit export paths, default |
Blender 5.1: /home/juan/blender-5.1.2/blender
Related MCP server: Blender MCP
Quick start
1. Install MCP server (Python)
cd /home/juan/source/blender_mcp_server
./scripts/setup_mcp.sh
cp config.example.json config.json # edit paths if needed2. Install Blender addon
BLENDER_VERSION=5.1 ./scripts/install_addon.sh
# Detect version: ls ~/.config/blender/In Blender:
Edit → Preferences → Add-ons → enable Blender MCP Bridge
N panel → MCP tab → Start Server (default
http://127.0.0.1:9876)
Or start headless with the default export blend:
./scripts/start_bridge.shLogs: bridge.log in this repo. Override blend: BLENDER_MCP_BLEND=/path/to/file.blend ./scripts/start_bridge.sh
3. Connect Cursor
Merge cursor.mcp.example.json into ~/.cursor/mcp.json:
{
"mcpServers": {
"blender": {
"command": "/home/juan/source/blender_mcp_server/.venv/bin/python",
"args": ["/home/juan/source/blender_mcp_server/server.py"],
"env": {
"BLENDER_MCP_CONFIG": "/home/juan/source/blender_mcp_server/config.json"
}
}
}
}Restart Cursor. Open this folder as workspace when animating.
4. Test
With Blender bridge running:
curl -s http://127.0.0.1:9876/healthIn Cursor chat (with MCP enabled):
Use ping_blender, then scene_information
MCP tools
Connection: ping_blender, get_server_config
Inspection: scene_information, list_objects, list_armatures, list_bones, list_actions, get_object_transform
Animation: create_action, rename_action, set_active_action, set_frame, set_bone_rotation_keyframe, set_action_loop_mode
Export / validate: export_gltf, export_to_summit, validate_scene_scale, validate_action_root_motion, validate_rts_asset, render_preview
Modeling (recipes): create_summit_bobcat — low-poly harvester blockout + idle / harvest animations
Bridge-only commands (not MCP tools yet)
Callable via scripts/run_command.py or HTTP bridge dispatch:
Command | Purpose |
| Breathing idle from a pose frame (quaternion offsets) |
| Forward rifle aim + recoil clip |
| Static hold from source action |
| Import walk GLB, remap bones, strip hip motion, create idle |
| Copy an action |
| Remove root bone location keys |
Human Rifleman pipeline (current)
Source blends live under ~/Documents/BlenderSaves/summit/:
File | Content |
|
|
|
|
|
|
| Merged master (idle + walk + attack) |
| Safety backup |
Regenerate walk + attack from stand (run FBX + procedural fire), then merge + export:
/home/juan/blender-5.1.2/blender --background --python scripts/prepare_rifleman_animations.pyBody textures (Ch36): merge exports from riflemenStand.blend (painted mesh). The exporter rebuilds Ch36_Body for glTF PBR and syncs packed images into the GLB. If sidecar PNGs look stale in Godot, reimport Rifleman.glb or run:
/home/juan/blender-5.1.2/blender --background --python scripts/fix_and_export_rifleman_body.py
/home/juan/blender-5.1.2/blender --background --python scripts/extract_textures_from_glb.pyRe-export only (if walk/fire blends already exist):
/home/juan/blender-5.1.2/blender --background --python scripts/prepare_rifleman_export.pyOutput: /home/juan/source/summit/Assets/Units/Human/Rifleman.glb
Godot view: Scenes/Units/HumanRiflemanView.tscn (animations idle, walk, attack).
Rifle mesh is parented to mixamorig1:RightHand in the fire blend. Attack uses explicit aim quaternions (+Y barrel forward), not a copied walk pose.
Or export from the open blend via MCP:
export_to_summit(target_key="summit_human_units", filename="Rifleman.glb", action_names=["idle","walk","attack"])Bobcat harvester (vehicle recipe)
V2 (RTS parts catalog — recommended)
Procedural Generals-style assembly from reusable mechanical parts:
BLENDER_VERSION=5.1 ./scripts/install_addon.sh
/home/juan/blender-5.1.2/blender --background --python scripts/create_summit_bobcat_v2.pyOutput blend: ~/Documents/BlenderSaves/summit/bobcatExport.blend
Silhouette preview: ~/Documents/BlenderSaves/summit/bobcat_v2_silhouette.png
Output GLB: /home/juan/source/summit/Assets/Units/Human/Bobcat.glb (idle, harvest)
MCP: create_summit_bobcat_v2, validate_rts_asset, validate_rts_silhouette, render_rts_silhouette_preview
Parts catalog (modeling/parts/): cabin, wheel, bucket, hydraulic, chassis, fender, exhaust, headlight, arm, grille.
Animated pivots (stable Godot contract): Bobcat_Arm_L, Bobcat_Arm_R, Bobcat_Bucket.
V1 (blockout)
/home/juan/blender-5.1.2/blender --background --python scripts/create_summit_bobcat.pySummit export
Config keys in config.json:
"export_targets": {
"summit_human_units": "/home/juan/source/summit/Assets/Units/Human",
"summit_props": "/home/juan/source/summit/Assets/Props"
}Default blend: riflemenExport.blend (see default_blend in config).
Then switch workspace to /home/juan/source/summit to wire Godot views and sim.
Summit conventions
Rule | Value |
Scale | 1 Blender unit = 1 meter |
Infantry height | ~1.6 m ( |
Forward | +Y in Blender |
Animation names |
|
Vehicle tri budget | 2500 tris (blockout recipe) |
Locomotion | Walk in place — no hip translation ( |
See also Summit player identity for team color masks when authoring units:
Paint tint regions in Blender (vertex color or
*_TeamMask.png)One GLB per unit type; player color applied at runtime in Godot
Human = military paint zones; Robot = LED emissive mask; etc.
Headless
blender mychar.blend --background --python scripts/run_command.py -- '{"command":"scene_information","args":{}}'Roadmap
Rifleman idle / walk / attack pipeline +
prepare_rifleman_export.pyBobcat blockout recipe +
create_summit_bobcat.pyvalidate_rts_asset+ MCP modeling toolscreate_natural_idle_action,create_rifle_attack_action(bridge)start_bridge.shheadless bridge daemonExpose locomotion commands as MCP tools
Team color mask validation / export hints for Summit shader
deathanimation for riflemanRigging helpers
Auto tool registration review gate
Available Tools
32 toolscreate_actionB
Create a new empty action (animation clip) with the given name.
Inputs: name (required). Returns: result
create_summit_bobcatC
Build Bobcat V1 blockout (simple boxes, idle + harvest).
Inputs: clear_existing. Returns: result
create_summit_bobcat_v2C
Build Bobcat V2 from RTS parts catalog (chunky Generals-style, idle + harvest).
Inputs: clear_existing. Returns: result
create_summit_gather_drone_v1C
Build Robot Gather Drone V1 — square hover harvester with suction (idle/harvest).
Inputs: clear_existing. Returns: result
create_summit_gentes_cyborg_v1C
Build Gentes Cyborg V1 — heavy infantry with minigun (idle/walk/attack).
Inputs: clear_existing. Returns: result
create_summit_jaguar_afv_v1B
Build Human Jaguar AFV V1 — tracked turret tank with cannon + coax trace pivots (idle/walk).
Inputs: clear_existing. Returns: result
create_summit_kold_deposit_v1C
Build Kold deposit V1 — low gold motes scattered on the ground.
Inputs: clear_existing. Returns: result
create_summit_operations_center_v1C
Build Human Operations Center V1 — NORAD-style HQ with roof whirlybirds (idle).
Inputs: clear_existing. Returns: result
create_summit_scavenger_v1C
Build Gentes Scavenger V1 — pickup harvester with front loader bucket (idle/harvest).
Inputs: clear_existing. Returns: result
create_summit_servo_mk0_v2C
Build Servo Mk0 V2 biped (shield, gun, digitigrade legs, idle/walk/attack).
Inputs: clear_existing. Returns: result
create_summit_zenox_ze_v1C
Build Zenox Ze V1 — sperm-like harvester with many tails (idle/walk/harvest).
Inputs: clear_existing. Returns: result
export_gltfC
Export glTF/GLB. action_names limits exported animations (None = all).
Inputs: output_path (required), action_names, export_format, apply_transform. Returns: result
export_to_summitC
Export to a configured Summit folder (see config export_targets).
Inputs: filename (required), target_key (required), action_names, export_format. Returns: result
get_object_transformB
Get location, rotation, and scale for an object.
Inputs: object_name (required). Returns: result
get_server_configA
Return MCP server config (bridge URL, export targets, Summit conventions).
Inputs: no named parameters. Returns: result
list_actionsA
List all actions (animation clips) in the blend file.
Inputs: no named parameters. Returns: result
list_armaturesA
List armature objects in the scene.
Inputs: no named parameters. Returns: result
list_bonesA
List bone names for an armature (pose or edit names).
Inputs: armature_name (required). Returns: result
list_objectsC
List objects. filter_type: ALL, MESH, ARMATURE, EMPTY, CURVE.
Inputs: filter_type. Returns: result
ping_blenderA
Check that Blender bridge is running and responding.
Inputs: no named parameters. Returns: result
rename_actionB
Rename an existing action.
Inputs: new_name (required), old_name (required). Returns: result
render_previewC
Render a still preview PNG from the active camera.
Inputs: output_path (required), frame, resolution_x, resolution_y. Returns: result
render_rts_silhouette_previewB
Orthographic top-down PNG for RTS silhouette review (~35m camera).
Inputs: root_name (required), output_path (required), resolution, camera_height_m. Returns: result
scene_informationA
Scene summary: file path, frame range, object/armature/action counts.
Inputs: no named parameters. Returns: result
set_action_loop_modeC
Set action cycle mode: REPEAT, CLAMP, or PING_PONG.
Inputs: action_name (required), loop_mode. Returns: result
set_active_actionC
Assign an action to an armature for editing/playback.
Inputs: action_name (required), armature_name (required). Returns: result
set_bone_rotation_keyframeC
Insert a rotation keyframe (Euler XYZ radians) on a pose bone.
Inputs: frame (required), bone_name (required), armature_name (required), rotation_euler (required), +1 more. Returns: result
set_frameC
Set the current scene frame.
Inputs: frame (required). Returns: result
validate_action_root_motionB
Warn if root bone has location keyframes (bad for in-place RTS locomotion).
Inputs: action_name (required), root_bone. Returns: result
validate_rts_assetC
Validate Summit RTS asset conventions (materials, tris, pivot, animations).
Inputs: root_name (required), asset_kind, reference_object. Returns: result
validate_rts_silhouetteB
RTS silhouette checks: forward axis, cab/wheels/arms/bucket, animated pivots.
Inputs: root_name (required), asset_kind. Returns: result
validate_scene_scaleB
Validate unit scale: checks mesh height vs Summit infantry target (~1.6m).
Inputs: reference_object. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 32 tools
Each tool has a highly specific and unique purpose, from creating individual RTS models (e.g., create_summit_bobcat) to distinct validation and export operations. No two tools appear to overlap in functionality, ensuring an agent can reliably select the correct tool.
Tool names follow a consistent verb_noun_snake_case pattern, with clear prefixes like create_, list_, validate_, and export_. Within each category, naming is uniform (e.g., create_summit_*_v# or validate_*), making the tool set predictable and easy to navigate.
32 tools is on the high side, but the server is focused on a specialized RTS asset pipeline, which justifies many specific model creators and validators. However, the sheer number may overwhelm agents, and some generic operations could be consolidated.
The tool set covers the full lifecycle for the Summit RTS asset domain: creation of multiple specific models, validation of conventions, animation management, and export. Minor gaps exist (e.g., no geometry or material editing), but core workflows are well supported.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server for Hailuo (MiniMax) AI video generation
MCP server for AI dialogue using various LLM models via AceDataCloud
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that enables AI models to directly control Blender for 3D modeling, scene manipulation, and material management through natural language. It supports advanced workflows including Python code execution, viewport visualization, and integration with external asset libraries like Poly Haven and Hyper3D.221MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that enables AI agents to control Blender through natural language for 3D scene creation, animation, and rendering. It provides over 550 actions and direct Python execution via a bridge to a live local Blender session.7MIT
- AlicenseAqualityDmaintenanceA Python-based MCP server for integrating Blender and 3D modeling capabilities with OpenClaw AI agents.221MIT
- AlicenseCqualityDmaintenanceMCP server that enables AI to control Blender 3D, providing 175 typed tools for objects, materials, animation, compositing, and more via the Model Context Protocol.1003MIT