Blender Dynamic MCP VXAI

A Node.js package for integrating Blender with Cursor MCP for dynamic scene manipulation.

Installation

npm install blender-dynamic-mcp-vxai

This will install the package and its dependencies, including the required Python packages.

Prerequisites

Node.js 14 or higher
Python 3.7 or higher
Blender 2.93 or higher with the MCP addon installed

Usage

Starting the server

You can start the server programmatically in your Node.js application:

const BlenderMCP = require('blender-dynamic-mcp-vxai');

// Create a new instance with default options
const server = new BlenderMCP();

// Start the server
server.start();

// Stop the server when done
server.stop();

Or you can start it directly from the command line:

npx blender-dynamic-mcp-vxai

Configuration Options

You can customize the server configuration by passing options to the constructor:

const server = new BlenderMCP({
  pythonPath: '/path/to/python', // Custom Python interpreter path
  host: 'localhost',             // Blender addon host
  port: 9876                     // Blender addon port
});

Using with Cursor MCP

This package is designed to work with Cursor MCP. Once the server is running, Cursor MCP can connect to it and use the available tools:

get_scene_info: Get detailed information about the current Blender scene
run_script: Execute a Python script in Blender to manipulate the scene

Blender Addon Setup

Make sure you have the Blender MCP addon installed in Blender
Start Blender and enable the addon
The addon will start a server on port 9876 by default

Troubleshooting

If you encounter connection issues, make sure Blender is running with the addon enabled
Check the logs in /tmp/blender_mcp_server.log for more information
Ensure the port (default: 9876) is not blocked by a firewall

License

MIT