rekordbox-mcp

Instructions

Implementation Reference

• rekordbox_mcp/server.py:688-747 (handler)

  Primary MCP tool handler decorated with @mcp.tool(). Performs safety checks (existence, smart playlist), calls database helper, formats response with status, message, and details.

  @mcp.tool(
      annotations={
          "readOnlyHint": False,
          "destructiveHint": True,
          "idempotentHint": True
      }
  )
  async def delete_playlist(playlist_id: str) -> Dict[str, Any]:
      """
      Delete a playlist from rekordbox.
      
      ⚠️ DANGER: This permanently deletes a playlist and cannot be undone!
      
      Args:
          playlist_id: ID of the playlist to delete
          
      Returns:
          Result of the operation
      """
      await ensure_database_connected()
      
      try:
          # Get playlist info before deletion for confirmation
          playlists = await db.get_playlists()
          target_playlist = next((p for p in playlists if p.id == playlist_id), None)
          
          if not target_playlist:
              return {
                  "status": "error",
                  "message": f"Playlist {playlist_id} not found"
              }
          
          # Prevent deletion of smart playlists for safety
          if target_playlist.is_smart_playlist:
              return {
                  "status": "error",
                  "message": "Cannot delete smart playlists - they are managed by rekordbox"
              }
          
          success = await db.delete_playlist(playlist_id)
          if success:
              return {
                  "status": "success",
                  "message": f"Deleted playlist '{target_playlist.name}' ({playlist_id})",
                  "deleted_playlist": {
                      "id": playlist_id,
                      "name": target_playlist.name,
                      "track_count": target_playlist.track_count
                  }
              }
          else:
              return {
                  "status": "error",
                  "message": "Failed to delete playlist"
              }
      except Exception as e:
          return {
              "status": "error",
              "message": f"Failed to delete playlist: {str(e)}"
          }

• rekordbox_mcp/database.py:892-924 (helper)

  RekordboxDatabase class method implementing the core deletion logic: creates backup, converts ID to int, calls pyrekordbox db.delete_playlist(), commits or rolls back.

  async def delete_playlist(self, playlist_id: str) -> bool:
      """
      Delete a playlist.
      
      Args:
          playlist_id: ID of the playlist to delete
          
      Returns:
          True if successful
      """
      if not self.db:
          raise RuntimeError("Database not connected")
      
      try:
          # Create backup before mutation
          await self._create_backup()
          
          # Delete playlist using pyrekordbox
          playlist_int_id = int(playlist_id)
          self.db.delete_playlist(playlist_int_id)
          
          # Commit changes
          self.db.commit()
          
          logger.info(f"Deleted playlist {playlist_id}")
          return True
          
      except Exception as e:
          logger.error(f"Failed to delete playlist {playlist_id}: {e}")
          # Rollback on error
          if hasattr(self.db, 'rollback'):
              self.db.rollback()
          raise RuntimeError(f"Failed to delete playlist: {str(e)}")

• rekordbox_mcp/server.py:688-694 (registration)

  @mcp.tool decorator registers the delete_playlist function as an MCP tool with destructive and idempotent hints.

  @mcp.tool(
      annotations={
          "readOnlyHint": False,
          "destructiveHint": True,
          "idempotentHint": True
      }
  )