graph LR
AI_Agent_Claude_AI_["AI Agent (Claude AI)"]
MCP_Orchestration_Server["MCP Orchestration Server"]
Blender_Application_Environment["Blender Application Environment"]
Blender_MCP_Addon["Blender MCP Addon"]
External_Asset_Generation_Services["External Asset & Generation Services"]
Unclassified["Unclassified"]
AI_Agent_Claude_AI_ -- "Sends Commands" --> MCP_Orchestration_Server
MCP_Orchestration_Server -- "Receives Responses" --> AI_Agent_Claude_AI_
MCP_Orchestration_Server -- "Forwards MCP Commands" --> Blender_MCP_Addon
Blender_MCP_Addon -- "Receives MCP Results" --> MCP_Orchestration_Server
Blender_MCP_Addon -- "Executes Blender API Calls" --> Blender_Application_Environment
Blender_MCP_Addon -- "Queries Scene State" --> Blender_Application_Environment
MCP_Orchestration_Server -- "Requests Assets/Models" --> External_Asset_Generation_Services
External_Asset_Generation_Services -- "Provides Assets/Models" --> MCP_Orchestration_Server
Blender_MCP_Addon -- "Initiates Asset/Model Operations" --> External_Asset_Generation_Services
External_Asset_Generation_Services -- "Returns Operation Status/Data" --> Blender_MCP_Addon
click MCP_Orchestration_Server href "https://github.com/CodeBoarding/GeneratedOnBoardings/blob/main/blender-mcp/MCP_Orchestration_Server.md" "Details"
click Blender_MCP_Addon href "https://github.com/CodeBoarding/GeneratedOnBoardings/blob/main/blender-mcp/Blender_MCP_Addon.md" "Details"
click External_Asset_Generation_Services href "https://github.com/CodeBoarding/GeneratedOnBoardings/blob/main/blender-mcp/External_Asset_Generation_Services.md" "Details"
The blender-mcp project facilitates AI-driven 3D model generation and manipulation within Blender. The architecture is centered around an AI Agent (Claude AI) that orchestrates the process by sending high-level commands to the MCP Orchestration Server. This server acts as a central broker, translating these commands into a Machine Control Protocol (MCP) and managing interactions with various External Asset & Generation Services (Poly Haven, Hyper3D, Sketchfab). The MCP Orchestration Server then forwards these MCP commands to the Blender MCP Addon, a plugin running within the Blender Application Environment. The Blender MCP Addon executes these commands by directly interacting with the Blender Python API, querying the scene state, and performing 3D manipulations. Results and scene information are then relayed back through the MCP Orchestration Server to the AI Agent (Claude AI). This setup allows for a clear separation of concerns, with the AI handling high-level decision-making, the orchestration server managing command translation and external service integration, and the Blender addon executing precise 3D operations.
The external intelligent agent that orchestrates the 3D modeling process, sending high-level commands and interpreting responses. This component is external to the project and interacts with the MCP Orchestration Server.
Related Classes/Methods:
MCP Orchestration Server [Expand]
A standalone Python server acting as the central broker, translating AI commands into MCP and managing interactions with external asset services.
Related Classes/Methods:
src.blender_mcp.server.server_lifespan:167-195src.blender_mcp.server.send_command:112-165src.blender_mcp.server.receive_full_response:56-110src.blender_mcp.server.get_scene_info:244-255src.blender_mcp.server.execute_blender_code:318-333src.blender_mcp.server.generate_hyper3d_model_via_text:711-745src.blender_mcp.server.download_polyhaven_asset:416-465src.blender_mcp.server.download_sketchfab_model:659-700
The core 3D modeling software (Blender) that provides the runtime environment for the Blender MCP Addon and fundamental 3D manipulation capabilities. This is an external application.
Related Classes/Methods:
addon.execute_command:182-190addon._execute_command_internal:192-251addon.get_scene_info:255-287addon.execute_code:405-420
Blender MCP Addon [Expand]
A Blender plugin containing an internal TCP server that receives and executes MCP commands, directly interacting with the Blender Python API.
Related Classes/Methods:
addon.start:43-65addon._server_loop:89-120addon._handle_client:122-180addon.execute_command:182-190addon._execute_command_internal:192-251addon.get_scene_info:255-287addon.execute_code:405-420addon.create_rodin_job:1140-1147addon.poll_rodin_job_status:1209-1216addon.import_generated_asset:1312-1319addon.download_polyhaven_asset:469-790
External Asset & Generation Services [Expand]
A collection of external online services providing 3D assets (Poly Haven, Sketchfab) and AI-powered model generation (Hyper3D/Rodin). Interactions with these services are managed by the MCP Orchestration Server and Blender MCP Addon.
Related Classes/Methods:
src.blender_mcp.server.download_polyhaven_asset:416-465addon.download_polyhaven_asset:469-790src.blender_mcp.server.generate_hyper3d_model_via_text:711-745addon.create_rodin_job:1140-1147addon.poll_rodin_job_status:1209-1216addon.import_generated_asset:1312-1319src.blender_mcp.server.download_sketchfab_model:659-700
Component for all unclassified files and utility functions (Utility functions/External Libraries/Dependencies)
Related Classes/Methods: None