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

1. Make sure you have the Blender MCP addon installed in Blender
2. Start Blender and enable the addon
3. 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