rekordbox-mcp

Instructions

Implementation Reference

• rekordbox_mcp/server.py:151-166 (handler)

  MCP tool handler decorated with @mcp.tool(). Ensures database connection, calls the database helper method, serializes Track models to dicts, and returns the list of most played tracks.

  @mcp.tool()
  async def get_most_played_tracks(limit: int = 20) -> List[Dict[str, Any]]:
      """
      Get the most played tracks in the library.
      
      Args:
          limit: Maximum number of tracks to return
          
      Returns:
          List of most played tracks
      """
      if not db:
          raise RuntimeError("Database not initialized.")
      
      tracks = await db.get_most_played_tracks(limit)
      return [track.model_dump() for track in tracks]

• rekordbox_mcp/database.py:310-320 (helper)

  Database class method that fetches all active content from pyrekordbox database, sorts by DJPlayCount descending, converts top limit contents to Track models using _content_to_track, and returns the list.

  async def get_most_played_tracks(self, limit: int = 20) -> List[Track]:
      """Get the most played tracks."""
      if not self.db:
          raise RuntimeError("Database not connected")
      
      all_content = list(self.db.get_content())
      active_content = [c for c in all_content if getattr(c, 'rb_local_deleted', 0) == 0]
      # Sort by play count descending
      sorted_content = sorted(active_content, key=lambda x: getattr(x, 'DJPlayCount', 0) or 0, reverse=True)
      
      return [self._content_to_track(content) for content in sorted_content[:limit]]