BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:711-746 (handler)

  The handler function for 'generate_hyper3d_model_via_text' tool. Decorated with @mcp.tool() for registration. Defines input schema via parameters (text_prompt: str, bbox_condition: list[float]=None). Sends 'create_rodin_job' command to Blender with text prompt and optional bbox_condition (processed by helper). Returns JSON with task details or error.
  @mcp.tool() def generate_hyper3d_model_via_text( ctx: Context, text_prompt: str, bbox_condition: list[float]=None ) -> str: """ Generate 3D asset using Hyper3D by giving description of the desired asset, and import the asset into Blender. The 3D asset has built-in materials. The generated model has a normalized size, so re-scaling after generation can be useful. Parameters: - text_prompt: A short description of the desired model in **English**. - bbox_condition: Optional. If given, it has to be a list of floats of length 3. Controls the ratio between [Length, Width, Height] of the model. Returns a message indicating success or failure. """ try: blender = get_blender_connection() result = blender.send_command("create_rodin_job", { "text_prompt": text_prompt, "images": None, "bbox_condition": _process_bbox(bbox_condition), }) succeed = result.get("submit_time", False) if succeed: return json.dumps({ "task_uuid": result["uuid"], "subscription_key": result["jobs"]["subscription_key"], }) else: return json.dumps(result) except Exception as e: logger.error(f"Error generating Hyper3D task: {str(e)}") return f"Error generating Hyper3D task: {str(e)}"
• src/blender_mcp/server.py:702-710 (helper)

  Supporting helper function used to normalize the bbox_condition parameter into a list of integers scaled relative to the maximum value (0-100 range). Called within the handler.
  def _process_bbox(original_bbox: list[float] | list[int] | None) -> list[int] | None: if original_bbox is None: return None if all(isinstance(i, int) for i in original_bbox): return original_bbox if any(i<=0 for i in original_bbox): raise ValueError("Incorrect number range: bbox must be bigger than zero!") return [int(float(i) / max(original_bbox) * 100) for i in original_bbox] if original_bbox else None