AbletonMCP

Implementation Reference

• MCP_Server/server.py:411-452 (handler)

  The handler function for the 'get_browser_tree' MCP tool. It connects to the Ableton remote script, sends the 'get_browser_tree' command with the specified category_type, receives the result, and formats it into a readable tree structure with error handling.
  @mcp.tool() def get_browser_tree(ctx: Context, category_type: str = "all") -> str: try: ableton = get_ableton_connection() result = ableton.send_command("get_browser_tree", {"category_type": category_type}) if "available_categories" in result and len(result.get("categories", [])) == 0: available_cats = result.get("available_categories", []) return (f"No categories found for '{category_type}'. " f"Available browser categories: {', '.join(available_cats)}") total_folders = result.get("total_folders", 0) formatted_output = f"Browser tree for '{category_type}' (showing {total_folders} folders):\n\n" def format_tree(item, indent=0): output = "" if item: prefix = " " * indent name = item.get("name", "Unknown") path = item.get("path", "") has_more = item.get("has_more", False) output += f"{prefix}• {name}" if path: output += f" (path: {path})" if has_more: output += " [...]" output += "\n" for child in item.get("children", []): output += format_tree(child, indent + 1) return output for category in result.get("categories", []): formatted_output += format_tree(category) + "\n" return formatted_output except Exception as e: error_msg = str(e) if "Browser is not available" in error_msg: logger.error(f"Browser is not available in Ableton: {error_msg}") return f"Error: The Ableton browser is not available. Make sure Ableton Live is fully loaded and try again." elif "Could not access Live application" in error_msg: logger.error(f"Could not access Live application: {error_msg}") return f"Error: Could not access the Ableton Live application. Make sure Ableton Live is running and the Remote Script is loaded." else: logger.error(f"Error getting browser tree: {error_msg}") return f"Error getting browser tree: {error_msg}"
• MCP_Server/server.py:411-411 (registration)

  The @mcp.tool() decorator registers the get_browser_tree function as an MCP tool.
  @mcp.tool()
• MCP_Server/server.py:474-474 (helper)

  Error message in get_browser_items_at_path tool that references get_browser_tree for checking available categories.
  return f"Error: {error_msg}. Please check the available categories using get_browser_tree."