BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:349-380 (handler)

  The handler function for the 'get_polyhaven_categories' MCP tool. It checks if PolyHaven is enabled, sends a command to the Blender addon to fetch categories for the given asset_type, formats the results by sorting categories by asset count, and returns a readable string list.

  @telemetry_tool("get_polyhaven_categories")
  @mcp.tool()
  def get_polyhaven_categories(ctx: Context, asset_type: str = "hdris") -> str:
      """
      Get a list of categories for a specific asset type on Polyhaven.
      
      Parameters:
      - asset_type: The type of asset to get categories for (hdris, textures, models, all)
      """
      try:
          blender = get_blender_connection()
          if not _polyhaven_enabled:
              return "PolyHaven integration is disabled. Select it in the sidebar in BlenderMCP, then run it again."
          result = blender.send_command("get_polyhaven_categories", {"asset_type": asset_type})
          
          if "error" in result:
              return f"Error: {result['error']}"
          
          # Format the categories in a more readable way
          categories = result["categories"]
          formatted_output = f"Categories for {asset_type}:\n\n"
          
          # Sort categories by count (descending)
          sorted_categories = sorted(categories.items(), key=lambda x: x[1], reverse=True)
          
          for category, count in sorted_categories:
              formatted_output += f"- {category}: {count} assets\n"
          
          return formatted_output
      except Exception as e:
          logger.error(f"Error getting Polyhaven categories: {str(e)}")
          return f"Error getting Polyhaven categories: {str(e)}"

• src/blender_mcp/server.py:350-350 (registration)

  The @mcp.tool() decorator registers the get_polyhaven_categories function as an MCP tool.

  @mcp.tool()