Blender

by cwahlfeldt

7 stars
Not rated
GitHub

About

Integrates with Blender's Python API to enable natural language-driven 3D modeling, scene generation, and animation scripting within the Blender environment.

Details

Author
cwahlfeldt
Repository
cwahlfeldt/blender-mcp
GitHub stars
7
Categories
Design, Developer Tools, AI, Infrastructure, Frontend
Tags
#integration

- 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)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Blender
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Clone this repository
2. Install the MCP library: pip install mcp
3. Ensure Blender is installed and accessible from your PATH

add_script

Add a new script. Parameters: name (string), content (string)

edit_script

Edit an existing script. Parameters: name (string), content (string)

execute_script

Execute a script in Blender, optionally specifying a .blend file. Parameters: name (string), blend_file (optional string)

remove_script

Remove a script. Parameters: name (string)

scripts://list

Get list of available scripts.

script://{name}

Get content of a specific script. Parameters: name (string)

result://{name}

Get execution result of a script. Parameters: name (string)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "blender": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

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

1. Start the server:

   python server.py

2. Connect to the server using an MCP client (like Claude Desktop)

3. Use the provided tools to manage scripts:
- add_script(name, content) - Add a new script
- edit_script(name, content) - Edit an existing script
- execute_script(name, blend_file=None) - Execute a script in Blender, optionally specifying a .blend file
- remove_script(name) - Remove a script

4. Access resources to get information:
- scripts://list - Get list of available scripts
- script://{name} - Get content of a specific script
- result://{name} - Get execution result of a script

Examples

Basic Example

```python

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.