Blender MCP Server
A Model Context Protocol (MCP) server for managing and executing Blender scripts.
Features
- Add, edit, execute, and remove Blender Python scripts
- Execute scripts in a headless Blender environment
- View execution results and errors
- Track script metadata (creation date, last modified, execution count)
Requirements
- Python 3.7+
- Blender installed and accessible
- MCP library (
pip install mcp)
Usage
-
Start the server:
python server.py -
Connect to the server using an MCP client (like Claude Desktop)
-
Use the provided tools to manage scripts:
add_script(name, content)- Add a new scriptedit_script(name, content)- Edit an existing scriptexecute_script(name, blend_file=None)- Execute a script in Blender, optionally specifying a .blend fileremove_script(name)- Remove a script
-
Access resources to get information:
scripts://list- Get list of available scriptsscript://{name}- Get content of a specific scriptresult://{name}- Get execution result of a script
Examples
Basic Example
# Add a simple script
add_script("hello_cube", '''
import bpy
# Clear existing objects
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete()
# Create a cube
bpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 0))
print("Cube created!")
''')
# Execute the script
execute_script("hello_cube")
# Get the result
# Access using: result://hello_cube
Working with Blend Files
# Add a script that works with a blend file
add_script("analyze_scene", '''
import bpy
# Print information about the current scene
print(f"Current Blender version: {bpy.app.version_string}")
print(f"Current file: {bpy.data.filepath}")
# List all objects in the scene
print("\\nObjects in the scene:")
for obj in bpy.data.objects:
print(f" - {obj.name} ({obj.type})")
''')
# Execute with a specific blend file
execute_script("analyze_scene", blend_file="/path/to/your/project.blend")
# Get the result
# Access using: result://analyze_scene
How It Works
- When a script is added, it's stored in the
script_files/scriptsdirectory - When executed, the script is run in a headless Blender instance
- If a blend file is specified, Blender will open that file before running the script
- Otherwise, a default empty Blender scene is used
- Output and errors are captured and stored in the
script_files/resultsdirectory - Metadata about scripts is tracked in
script_files/metadata.json
Installation
- Clone this repository
- Install the MCP library:
pip install mcp - Ensure Blender is installed and accessible from your PATH
License
MIT
Metadata
Release files for iflow-mcp_cwahlfeldt_blender-mcp 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_cwahlfeldt_blender_mcp-0.1.3.tar.gz | 26.7 kB | Without provenance | Details for iflow_mcp_cwahlfeldt_blender_mcp-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_cwahlfeldt_blender_mcp-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_cwahlfeldt_blender_mcp-0.1.3-py3-none-any.whl |
Total release size: 41.9 kB
Release files / iflow_mcp_cwahlfeldt_blender_mcp-0.1.3.tar.gz
| Download URL | iflow_mcp_cwahlfeldt_blender_mcp-0.1.3.tar.gz |
|---|---|
| Size | 26.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
60fe671eb55ed6fcf8240e7e42a26bc755f6ec09a2af689aa5e9c2f497b43847
|
|
BLAKE2b-256 checksum How to use checksums |
67a761b60bfb37a580c8f6a17504c9c2d8fbd97092f6b8a660be02b903fa6be6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_cwahlfeldt_blender_mcp-0.1.3-py3-none-any.whl
| Download URL | iflow_mcp_cwahlfeldt_blender_mcp-0.1.3-py3-none-any.whl |
|---|---|
| Size | 15.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0dd112ae335e11c5d643fd0c26f37e4668d62168ca9596090658c8e4500a4bf0
|
|
BLAKE2b-256 checksum How to use checksums |
ef179180875ffd8d7f03f951e87d4faf0d2bb150303ed7fbd5066c7b736cb592
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_cwahlfeldt_blender-mcp 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.