BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:382-408 (handler)

  The search_polyhaven_assets function is the handler for the MCP tool. It validates the input and delegates the request to the Blender connection via send_command.

  @telemetry_tool("search_polyhaven_assets")
  @mcp.tool()
  def search_polyhaven_assets(
      ctx: Context,
      asset_type: str = "all",
      categories: str = None
  ) -> str:
      """
      Search for assets on Polyhaven with optional filtering.
      
      Parameters:
      - asset_type: Type of assets to search for (hdris, textures, models, all)
      - categories: Optional comma-separated list of categories to filter by
      
      Returns a list of matching assets with basic information.
      """
      try:
          blender = get_blender_connection()
          result = blender.send_command("search_polyhaven_assets", {
              "asset_type": asset_type,
              "categories": categories
          })
          
          if "error" in result:
              return f"Error: {result['error']}"
          
          # Format the assets in a more readable way