BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:467-498 (handler)

  The `set_texture` tool handler which sends the command to the Blender instance.

  @mcp.tool()
  def set_texture(
      ctx: Context,
      object_name: str,
      texture_id: str
  ) -> str:
      """
      Apply a previously downloaded Polyhaven texture to an object.
      
      Parameters:
      - object_name: Name of the object to apply the texture to
      - texture_id: ID of the Polyhaven texture to apply (must be downloaded first)
      
      Returns a message indicating success or failure.
      """
      try:
          # Get the global connection
          blender = get_blender_connection()
          result = blender.send_command("set_texture", {
              "object_name": object_name,
              "texture_id": texture_id
          })
          
          if "error" in result:
              return f"Error: {result['error']}"
          
          if result.get("success"):
              material_name = result.get("material", "")
              maps = ", ".join(result.get("maps", []))
              
              # Add detailed material info
              material_info = result.get("material_info", {})