AbletonMCP

Implementation Reference

• MCP_Server/server.py:453-481 (handler)

  MCP tool handler for get_browser_items_at_path. Connects to Ableton, sends the command with the given path, handles the result or specific errors, and returns JSON or formatted error message.

  @mcp.tool()
  def get_browser_items_at_path(ctx: Context, path: str) -> str:
      try:
          ableton = get_ableton_connection()
          result = ableton.send_command("get_browser_items_at_path", {"path": path})
          if "error" in result and "available_categories" in result:
              error = result.get("error", "")
              available_cats = result.get("available_categories", [])
              return (f"Error: {error}\n"
                     f"Available browser categories: {', '.join(available_cats)}")
          return json.dumps(result, indent=2)
      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."
          elif "Unknown or unavailable category" in error_msg:
              logger.error(f"Invalid browser category: {error_msg}")
              return f"Error: {error_msg}. Please check the available categories using get_browser_tree."
          elif "Path part" in error_msg and "not found" in error_msg:
              logger.error(f"Path not found: {error_msg}")
              return f"Error: {error_msg}. Please check the path and try again."
          else:
              logger.error(f"Error getting browser items at path: {error_msg}")
              return f"Error getting browser items at path: {error_msg}"