rekordbox-mcp
Rekordbox MCP-Server
Ein umfassender Model Context Protocol (MCP)-Server für die rekordbox-Datenbankverwaltung mit Echtzeit-Datenbankzugriff.
Erstellt mit pyrekordbox – Dieses Projekt steht in keiner Verbindung zum pyrekordbox-Projekt oder dessen Betreuern.
Funktionen
🗄️ Datenbankzugriff
Direkte SQLite-Datenbankverbindung: Zugriff auf die verschlüsselte rekordbox-Datenbank direkt über pyrekordbox
Echtzeit-Abfragen: Suchen und Filtern von Titeln mit umfassenden Kriterien
Sichere Mutationsvorgänge: Wiedergabelistenverwaltung mit automatischen Backups und Sicherheitsanmerkungen
🔍 Suche & Entdeckung
Erweiterte Suche: Suche über mehrere Felder hinweg, einschließlich Interpret, Titel, Genre, Tonart, BPM und mehr
Filterung nach musikalischer Tonart: Finden Sie Titel in kompatiblen Tonarten für harmonisches Mixing
BPM-Bereichsabfragen: Suche nach Tempo-Bereichen für Beatmatching
Bewertungs- und Wiedergabefilter: Entdecken Sie Ihre beliebtesten und am häufigsten gespielten Titel
📊 Analysen & Einblicke
Bibliotheksstatistiken: Umfassende Statistiken, einschließlich Genre-Verteilung, durchschnittlicher BPM und Gesamtabspielzeit
Wiedergabe-Analysen: Nachverfolgung von Hörgewohnheiten und Mustern
Sammlungseinblicke: Verstehen Sie die Zusammensetzung Ihrer Musikbibliothek
Zugriff auf DJ-Verlauf: Voller Zugriff auf Ihren DJ-Sitzungsverlauf und Leistungsdaten
⚙️ Datenbankoperationen
Wiedergabelistenverwaltung: Erstellen, Ändern und Löschen von Wiedergabelisten mit Sicherheitsschutz
Stapelverarbeitung: Effizientes Hinzufügen mehrerer Titel zu Wiedergabelisten
Verlaufsanalyse: Zugriff auf den vollständigen DJ-Sitzungsverlauf und Leistungsdaten
Bibliotheksstatistiken: Umfassende Analysen und Einblicke
Related MCP server: AbletonMCP
Architektur
FastMCP-Framework: Moderner Python-MCP-Server unter Verwendung von FastMCP 2.0
pyrekordbox-Integration: Ausgereifte Bibliothek für den Zugriff auf verschlüsselte Datenbanken
Echtzeit-Datenbankabfragen: Direkte SQLite-Operationen mit SQLCipher-Unterstützung
Produktionsbereit: Integrierte Protokollierung, Fehlerbehandlung und Sicherheitsfunktionen
⚠️ Wichtiger Sicherheitshinweis
ERSTELLEN SIE VOR DER VERWENDUNG EIN BACKUP IHRER REKORDBOX-BIBLIOTHEK
Diese Software greift direkt auf Ihre rekordbox-Datenbank zu. Erstellen Sie als Vorsichtsmaßnahme immer ein Backup Ihrer gesamten rekordbox-Bibliothek, bevor Sie dieses Tool verwenden.
Backup-Anforderungen
Sie sollten ein vollständiges Backup Ihrer rekordbox-Bibliothek erstellen, bevor Sie diese Software verwenden. Konsultieren Sie die rekordbox-Dokumentation oder Support-Ressourcen für die korrekten Backup-Verfahren für Ihr spezifisches Setup und Ihre rekordbox-Version.
Anerkennung der Risiken
⚠️ Dieses Projekt greift direkt auf Ihre rekordbox-Datenbank zu
⚠️ Verwendung auf eigene Gefahr – keine Gewährleistung
⚠️ Vor der Verwendung mit Ihrer Hauptbibliothek gründlich mit Backups testen
⚠️ Die Entwickler sind nicht für Datenverlust oder Schäden verantwortlich
Wenn Sie sich mit diesen Risiken nicht wohl fühlen, verwenden Sie stattdessen die schreibgeschützte XML-Exportfunktion.
Schnellstart
Voraussetzungen
Python 3.12+
rekordbox 6 oder 7 installiert mit einer bestehenden Bibliothek
VOLLSTÄNDIGES BACKUP Ihrer rekordbox-Bibliothek (siehe Sicherheitshinweis oben)
Schreibgeschützte Tools (Suche, Statistiken, Verlauf) funktionieren, während rekordbox geöffnet ist
Schreib-Tools (Wiedergabeliste erstellen, Titel hinzufügen, Bereinigung) erfordern, dass rekordbox geschlossen ist – pyrekordbox blockiert Commits, wenn rekordbox läuft
Zugriff auf Ihre rekordbox-Datenbank (automatische Erkennung wird unterstützt)
Installation
# Install dependencies with uv
uv sync
# Run the server
uv run rekordbox-mcpKonfiguration
Der Server unterstützt sowohl die automatische Datenbankerkennung als auch die manuelle Konfiguration:
# Auto-detect rekordbox database (recommended)
uv run rekordbox-mcp
# Specify custom database path
uv run rekordbox-mcp --database-path /path/to/rekordbox/PioneerMCP-Client-Einrichtung
Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu:
{
"mcpServers": {
"rekordbox-database": {
"command": "uv",
"args": ["run", "rekordbox-mcp"],
"cwd": "/path/to/rekordbox-mcp"
}
}
}Verfügbare Tools (29 Tools + 1 Ressource)
Suche & Entdeckung
search_tracks- Erweiterte Suche über mehrere Felder mit Filterung (Genre, Tonart, BPM, Interpret, Titel, Bewertung usw.)get_track_details- Abrufen vollständiger Metadaten für einen bestimmten Titel per IDget_tracks_by_key- Finden von Titeln in einer bestimmten musikalischen Tonart (z. B. "5A", "12B")get_tracks_by_bpm_range- Finden von Titeln innerhalb eines BPM-Bereichsget_genre_filepaths- Abrufen von Dateipfaden für Titel, die einem Genre entsprechen (token-effizient, gibt nur Pfade zurück)get_most_played_tracks- Abrufen von Titeln, sortiert nach Wiedergabeanzahlget_top_rated_tracks- Abrufen von Titeln, sortiert nach Bewertungget_unplayed_tracks- Abrufen von Titeln mit null Wiedergabenget_track_file_path- Abrufen des Dateisystempfads für einen bestimmten Titelsearch_tracks_by_filename- Suchen von Titeln nach teilweiser Übereinstimmung des Dateinamens
Bibliotheksanalysen
get_library_stats- Umfassende Bibliotheksstatistiken (Titelanzahl, Abspielzeit, BPM, Genres)analyze_library- Benutzerdefinierte Gruppierung und Aggregation (nach Genre, Tonart, Jahr, Interpret oder Bewertung)validate_track_ids- Überprüfen einer Liste von Titel-IDs und Berichten, welche gültig/ungültig sind
Wiedergabelisten-Operationen
get_playlists- Auflisten aller Wiedergabelisten, einschließlich intelligenter Wiedergabelistenget_playlist_tracks- Abrufen aller Titel in einer bestimmten Wiedergabelistecreate_playlist- Erstellen einer neuen Wiedergabeliste oder eines Ordners ⚠️ (Mutation)add_track_to_playlist- Hinzufügen eines einzelnen Titels zur Wiedergabeliste ⚠️ (Mutation)add_tracks_to_playlist- Hinzufügen mehrerer Titel zur Wiedergabeliste in einem Vorgang ⚠️ (Mutation)remove_track_from_playlist- Entfernen eines Titels aus der Wiedergabeliste ⚠️ (Mutation)delete_playlist- Dauerhaftes Löschen einer Wiedergabeliste ⚠️ (Destruktiv)
DJ-Verlauf & Analysen
get_history_sessions- Abrufen aller DJ-Verlaufssitzungen mit Metadatenget_session_tracks- Abrufen aller in einer bestimmten Sitzung gespielten Titelget_recent_sessions- Abrufen von Sitzungen innerhalb einer bestimmten Anzahl von Tagensearch_history_sessions- Suchen von Sitzungen nach Name, Jahr, Monat oder Mindestanzahl an Titelnget_history_stats- Umfassende Statistiken und Einblicke zur DJ-Performance
Bibliotheksbereinigung
find_broken_tracks- Scannen nach fehlenden Dateien, Apple Music-Streams, leeren Pfaden und verwaisten Wiedergabelisten-Referenzencleanup_orphaned_playlist_entries- Entfernen veralteter Wiedergabelisteneinträge, die auf gelöschte Titel verweisen ⚠️ (Mutation)remove_broken_tracks- Soft-Löschen von Titeln nach ID und Entfernen aus allen Wiedergabelisten ⚠️ (Destruktiv)
Datenbankverwaltung
connect_database- Explizites Verbinden mit optionalem benutzerdefiniertem Datenbankpfad
Ressourcen
database-status- Aktueller Verbindungsstatus und grundlegende Statistiken
⚠️ Mutationsvorgänge ändern Ihre rekordbox-Datenbank und erstellen automatische Backups ⚠️ Destruktive Vorgänge löschen Daten dauerhaft und erfordern eine zusätzliche Bestätigung
Beispiele
Suche nach Titeln nach Tonart und BPM
# Find tracks in 5A key with BPM between 120-130
search_tracks(key="5A", bpm_min=120, bpm_max=130, limit=20)Zugriff auf den DJ-Verlauf
# Get recent DJ sessions
get_recent_sessions(days=30)
# Get tracks from a specific session
get_session_tracks(session_id="12345")Einblicke in die Bibliothek erhalten
# Comprehensive library statistics
get_library_stats()
# DJ performance statistics
get_history_stats()Wiedergabelistenverwaltung
# Create a new playlist
create_playlist(name="Hidden Bangers", parent_id="root")
# Add single track to playlist
add_track_to_playlist(playlist_id="136766232", track_id="218048716")
# Add multiple tracks efficiently (recommended for batch operations)
add_tracks_to_playlist(
playlist_id="136766232",
track_ids=["218048716", "253968855", "148359536", "76341043"]
)
# Remove track from playlist
remove_track_from_playlist(playlist_id="136766232", track_id="218048716")
# Delete playlist (with safety confirmation)
delete_playlist(playlist_id="136766232")Sicherheitsfunktionen
Automatische Backups: Alle Mutationsvorgänge erstellen vor Änderungen automatische Datenbank-Backups
FastMCP-Sicherheitsanmerkungen: Korrekte Sicherheitshinweise für Mutations- und destruktive Vorgänge
Schutz intelligenter Wiedergabelisten: Verhindert das Löschen intelligenter Wiedergabelisten
Verbindungsvalidierung: Validiert Datenbankverbindungen und Zugriff
Fehlerbehandlung: Umfassende Fehlerbehandlung mit detaillierter Protokollierung und Rollback
Eingabevalidierung: Eingabevalidierung für alle Datenbankoperationen
Sicherheit bei Stapelverarbeitung: Detaillierte Berichterstattung über Erfolg/Misserfolg von Stapelvorgängen
⚠️ Wichtig: Diese Sicherheitsfunktionen sind ergänzende Schutzmaßnahmen. Führen Sie immer Ihre eigenen Backups durch und verwenden Sie diese Software auf eigene Gefahr.
Entwicklung
Projektstruktur
rekordbox_mcp/
__init__.py # Package initialization
server.py # FastMCP server and tool definitions
database.py # Database connection and operations
models.py # Pydantic data modelsTests ausführen
uv run pytestCode-Qualität
# Format code
uv run black rekordbox_mcp/
# Lint code
uv run ruff rekordbox_mcp/
# Type checking
uv run mypy rekordbox_mcp/Lizenz
MIT-Lizenz
Haftungsausschluss
⚠️ VERWENDUNG AUF EIGENE GEFAHR ⚠️
Dieses Projekt ist nicht mit AlphaTheta (Pioneer DJ) oder dem pyrekordbox-Projekt verbunden
Diese Software greift direkt auf Ihre rekordbox-Datenbank zu
Es wird keine Gewährleistung oder Garantie übernommen
Die Entwickler sind nicht verantwortlich für Schäden an Ihrer rekordbox-Bibliothek
Sie tragen das volle Risiko, wenn Sie diese Software verwenden
Erstellen Sie IMMER ein Backup Ihrer rekordbox-Bibliothek vor der Verwendung. Testen Sie gründlich mit Backup-Kopien, bevor Sie sie auf Ihrer Hauptbibliothek verwenden.
Durch die Nutzung dieser Software bestätigen Sie, dass Sie diese Risiken verstehen und zustimmen, sie auf eigene Verantwortung zu nutzen.
Available Tools
25 toolsadd_tracks_to_playlistAIdempotent
Add multiple tracks to an existing playlist in one operation.
⚠️ CAUTION: This modifies your rekordbox database!
Args: playlist_id: ID of the playlist to modify track_ids: List of track IDs to add
Returns: Detailed results of the batch operation
Inputs: playlist_id (required), track_ids (required). Returns: object
add_track_to_playlistAIdempotent
Add a track to an existing playlist.
⚠️ CAUTION: This modifies your rekordbox database!
Args: playlist_id: ID of the playlist to modify track_id: ID of the track to add
Returns: Result of the operation
Inputs: playlist_id (required), track_id (required). Returns: object
analyze_libraryB
Analyze library with grouping and aggregation.
Args: group_by: Field to group by (genre, key, year, artist, rating) aggregate_by: Aggregation method (count, playCount, totalTime) top_n: Number of top results to return
Returns: Analysis results
Inputs: group_by, aggregate_by, top_n. Returns: object
connect_databaseB
Connect to the rekordbox database.
Args: database_path: Optional path to database directory. If not provided, auto-detection is used.
Returns: Connection status message
Inputs: database_path. Returns: object
create_playlistA
Create a new playlist in rekordbox.
⚠️ CAUTION: This modifies your rekordbox database!
Args: name: Name for the new playlist parent_id: Optional parent folder ID (omit for root level)
Returns: Information about the created playlist
Inputs: name (required), parent_id. Returns: object
delete_playlistADestructiveIdempotent
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
Inputs: playlist_id (required). Returns: object
get_history_sessionsB
Get DJ history sessions from rekordbox.
Args: include_folders: Whether to include folder entries (years/months) limit: Maximum number of sessions to return
Returns: List of history sessions with metadata
Inputs: include_folders, limit. Returns: result
get_history_statsB
Get comprehensive statistics about DJ history sessions.
Returns: Statistics about all history sessions including totals and trends
Inputs: no named parameters. Returns: object
get_library_statsC
Get comprehensive library statistics.
Returns: Dictionary containing various library statistics
Inputs: no named parameters. Returns: object
get_most_played_tracksC
Get the most played tracks in the library.
Args: limit: Maximum number of tracks to return
Returns: List of most played tracks
Inputs: limit. Returns: result
get_playlistsA
Get all playlists from the rekordbox database.
Returns: List of playlists with metadata
Inputs: no named parameters. Returns: result
get_playlist_tracksC
Get all tracks in a specific playlist.
Args: playlist_id: The unique playlist identifier
Returns: List of tracks in the playlist
Inputs: playlist_id (required). Returns: result
get_recent_sessionsB
Get recent DJ history sessions within the specified number of days.
Args: days: Number of days to look back (default: 30)
Returns: List of recent history sessions
Inputs: days. Returns: result
get_session_tracksB
Get all tracks from a specific DJ history session.
Args: session_id: The session's unique identifier
Returns: List of tracks in the session with performance context
Inputs: session_id (required). Returns: result
get_top_rated_tracksB
Get the highest rated tracks in the library.
Args: limit: Maximum number of tracks to return
Returns: List of top rated tracks
Inputs: limit. Returns: result
get_track_detailsB
Get detailed information about a specific track.
Args: track_id: The unique track identifier
Returns: Detailed track information including metadata, cue points, and play history
Inputs: track_id (required). Returns: object
get_track_file_pathB
Get the file system path for a specific track.
Args: track_id: The unique track identifier
Returns: Dictionary containing file path information
Inputs: track_id (required). Returns: object
get_tracks_by_bpm_rangeB
Get tracks within a specific BPM range.
Args: bpm_min: Minimum BPM bpm_max: Maximum BPM
Returns: List of tracks within the BPM range
Inputs: bpm_min (required), bpm_max (required). Returns: result
get_tracks_by_keyC
Get all tracks in a specific musical key.
Args: key: Musical key (e.g., "5A", "12B")
Returns: List of tracks in the specified key
Inputs: key (required). Returns: result
get_unplayed_tracksB
Get tracks that have never been played.
Args: limit: Maximum number of tracks to return
Returns: List of unplayed tracks
Inputs: limit. Returns: result
remove_track_from_playlistAIdempotent
Remove a track from a playlist.
⚠️ CAUTION: This modifies your rekordbox database!
Args: playlist_id: ID of the playlist to modify track_id: ID of the track to remove
Returns: Result of the operation
Inputs: playlist_id (required), track_id (required). Returns: object
search_history_sessionsB
Search DJ history sessions with various filters.
Args: query: Search query for session names year: Filter by year (e.g., "2025") month: Filter by month (e.g., "08" for August) min_tracks: Minimum number of tracks in session limit: Maximum number of results
Returns: List of matching history sessions
Inputs: query, year, month, min_tracks, +1 more. Returns: result
search_tracksB
Search tracks in the rekordbox database.
Args: query: General search query (searches across multiple fields) artist: Filter by artist name title: Filter by track title genre: Filter by genre key: Filter by musical key (e.g., "5A", "12B") bpm_min: Minimum BPM bpm_max: Maximum BPM rating_min: Minimum rating (0-5) limit: Maximum number of results to return
Returns: List of matching tracks with metadata
Inputs: query, artist, title, genre, +5 more. Returns: result
search_tracks_by_filenameB
Search for tracks by filename.
Args: filename: Filename to search for (partial match)
Returns: List of tracks matching the filename
Inputs: filename (required). Returns: result
validate_track_idsC
Validate a list of track IDs and show which are valid/invalid.
Args: track_ids: List of track IDs to validate
Returns: Validation results with valid and invalid IDs
Inputs: track_ids (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Most tools have distinct purposes with clear boundaries, such as playlist management vs. track retrieval vs. analysis. However, some overlap exists between 'add_tracks_to_playlist' and 'add_track_to_playlist', which could cause confusion about when to use the batch vs. single operation, and between 'get_history_sessions' and 'get_recent_sessions', which differ only in time scope. Descriptions help clarify these distinctions, but the overlap is noticeable.
Tool names follow a highly consistent verb_noun pattern throughout, using snake_case uniformly. Examples include 'create_playlist', 'delete_playlist', 'get_track_details', and 'search_tracks'. This predictability makes it easy for agents to understand and navigate the toolset without confusion from mixed conventions.
With 25 tools, the count is borderline high for a rekordbox management server, potentially feeling heavy. While many tools are justified for comprehensive library and playlist operations, some could be consolidated (e.g., the two add-to-playlist tools) to reduce complexity. It's not extreme, but it approaches the upper limit of what's manageable.
The toolset provides complete coverage for rekordbox management, including CRUD for playlists (create, get, delete, add/remove tracks), extensive track retrieval (by BPM, key, rating, etc.), history session analysis, library statistics, and search capabilities. There are no obvious gaps; agents can perform all core workflows from database connection to detailed track manipulation and analysis.
Maintenance
Related MCP Connectors
Remote MCP server for full read/write access to a Zotero library
An MCP server for search and retrieval over a local LanceDB database
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
MCP server for Yoto: manage cards, tracks, icons and family devices from any MCP client.
Related MCP Servers
- MIT
- AlicenseBqualityCmaintenanceConnects Ableton Live to Claude AI through the Model Context Protocol, enabling AI-assisted music production by allowing Claude to directly interact with and control Ableton Live sessions.162,417 PyPI3,403MIT
- AlicenseNot gradedqualityCmaintenanceThis MCP server provides access to DEVONthink functionality via the Model Context Protocol (MCP). It enables listing, searching, creating, modifying, and managing records and databases in DEVONthink Pro on macOS.32 npm104GPL 3.0
- AlicenseAqualityDmaintenanceA comprehensive MCP server for rekordbox database management with real-time database access, enabling track search, playlist operations, library analytics, and DJ history retrieval.31MIT