Blender-mcp-vxai

New Features

1. **Robust Script Output Capture**
- **Description**: The `run_script` tool now captures all standard output (e.g., `print` statements) from executed Python scripts in Blender, alongside any user-defined `result` variable, providing comprehensive feedback.
- **Benefit**: Users and AI models can see exactly what a script outputs, not just a success message, enabling better debugging and interaction with Blender’s state.
- **Example**: Running `print("Hello")` and `result = {"key": "value"}` returns:
json
{
"message": "Script executed successfully",
"output": "Hello\n",
"result": {"key": "value"}
}


2. **Animation Rig Data Integration**
- **Description**: Added optional `include_rig_data` and `armature_name` parameters to `run_script`, allowing automatic retrieval of detailed animation rig information (e.g., bone positions, keyframes) without requiring custom scripting.
- **Benefit**: Simplifies access to armature data for animation workflows, reducing the need for complex script logic in AI-driven tasks.
- **Details**: Returns a `rig_data` field with bone counts, positions, and keyframe data for the specified or first armature.
- **Example**: `{"script": "import bpy", "include_rig_data": true, "armature_name": "CharacterRig"}` might return:
json
{
"rig_data": {
"name": "CharacterRig",
"bone_count": 3,
"bones": {...},
"keyframes": {...}
}
}


3. **Enhanced Error Handling**
- **Description**: Script execution errors now include full stack traces in the response, making it easier to diagnose and fix issues.
- **Benefit**: Provides actionable insights into script failures, improving reliability for automated systems and manual debugging.
- **Example**: A syntax error returns:
json
{
"message": "Script execution failed: invalid syntax...\n<full traceback>",
"output": "",
"result": null
}


---

Improvements

- **Script Execution Safety**: Limited the global namespace during script execution to `{bpy, math, random}`, reducing the risk of unintended side effects while maintaining flexibility.
- **Response Structure**: Standardized the `run_script` response to always include `message`, `output`, and `result` fields (plus `rig_data` if requested), ensuring consistent output for parsing.
- **Logging**: Enhanced logging in both the addon and server to track script execution details, stored in `/tmp/blender_mcp_addon.log` and `/tmp/blender_mcp_server.log`.

--> Advanced Scene Data Retrieval: The updated Blender MCP server enhances get_scene_info to fetch detailed scene data with customizable filters (e.g., object type, name, spatial bounds) and properties (e.g., vertices, modifiers).

--> Efficient Pagination: Supports limit and offset parameters for paginated data retrieval, optimizing performance when handling large Blender scenes.

--> Timeout Control: Includes timeout settings to prevent hangs, ensuring smooth operation even with complex queries or extensive scenes.

--> Dynamic Script Execution: The run_script tool allows seamless execution of Python scripts using Blender’s API, enabling programmatic scene manipulation.

--> Reliable and Stable: Features robust logging and automatic reconnection logic, making it dependable for AI-driven workflows via Cursor-side integration.

Updated start command to
uvx blender-mcp-vxai

Below are the release notes for **v1.0.3**, highlighting the key improvements and fixes in this version.

---

Blender MCP 1.0.2 Release Notes

This release focuses on improving the reliability and compatibility of the Blender MCP server and addon, addressing key issues related to script execution, connection stability, and context management in Blender.

Key Improvements

- **Increased Connection Timeout**
Extended the connection timeout from 15 seconds to 60 seconds to better accommodate longer-running scripts, such as those creating complex scenes or multiple objects.

- **Base64 Encoding for Scripts**
Scripts are now encoded in base64 on the server side and decoded in the addon, ensuring reliable transmission and preventing issues related to character encoding or formatting during network transfer.

- **Context Override for Script Execution**
Added support for Blender's `temp_override` to provide a 3D view context during script execution (for Blender 3.2+). This resolves issues with operators (e.g., `bpy.ops.mesh.primitive_cube_add`) that require a specific context to function correctly. For Blender versions older than 3.2, scripts are executed without context override, and a warning is logged if potential issues arise.

- **Pre-imported Modules in Script Environment**
The `math` and `random` modules are now pre-imported in the script execution environment to prevent errors like "name 'math' is not defined," ensuring smoother execution even if there are import issues in the script.

- **Enhanced Logging for Data Reception**
Improved logging in the `receive_full_response` method to track data reception more effectively, aiding in the diagnosis of connection timeouts and other communication issues.

Bug Fixes

- Fixed script execution failures caused by missing module imports (e.g., `math`, `random`).
- Resolved context-related errors for operators requiring a 3D view context.
- Addressed connection timeouts during complex or time-consuming script executions.

---

These updates make Blender MCP more robust, ensuring smoother integration and execution of scripts, especially in scenarios involving complex operations or older Blender versions.