BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:367-396 (handler)

  The search_polyhaven_assets tool handler in src/blender_mcp/server.py, which communicates with Blender to perform the actual search.

  @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
          assets = result["assets"]
          total_count = result["total_count"]
          returned_count = result["returned_count"]