rekordbox-mcp
Rekordbox MCP Server
リアルタイムのデータベースアクセスを備えた、rekordboxデータベース管理用の包括的なModel Context Protocol (MCP) サーバーです。
pyrekordbox を使用して構築されています - このプロジェクトは、pyrekordboxプロジェクトやそのメンテナーとは提携していません。
機能
🗄️ データベースアクセス
直接的なSQLiteデータベース接続: pyrekordboxを使用して、暗号化されたrekordboxデータベースに直接アクセスします
リアルタイムクエリ: 包括的な条件でトラックを検索・フィルタリングします
安全な変更操作: 自動バックアップと安全注釈付きのプレイリスト管理
🔍 検索と発見
高度な検索: アーティスト、タイトル、ジャンル、キー、BPMなどを横断した複数フィールド検索
音楽キーフィルタリング: ハーモニックミキシングに適したキーのトラックを検索
BPM範囲クエリ: ビートマッチングのためのテンポ範囲による検索
評価と再生回数フィルタ: お気に入りのトラックや再生回数の多いトラックを発見
📊 分析とインサイト
ライブラリ統計: ジャンル分布、平均BPM、合計再生時間などの包括的な統計
再生回数分析: トラックのリスニングパターンと習慣を追跡
コレクションインサイト: 音楽ライブラリの構成を把握
DJ履歴アクセス: DJセッション履歴とパフォーマンスデータへの完全アクセス
⚙️ データベース操作
プレイリスト管理: 安全保護付きでプレイリストを作成、変更、削除
バッチ操作: 複数のトラックを効率的にプレイリストに追加
履歴分析: DJセッション履歴とパフォーマンスデータへの完全アクセス
ライブラリ統計: 包括的な分析とインサイト
Related MCP server: AbletonMCP
アーキテクチャ
FastMCPフレームワーク: FastMCP 2.0を使用した最新のPython MCPサーバー
pyrekordbox統合: 暗号化されたデータベースアクセスのための成熟したライブラリ
リアルタイムデータベースクエリ: SQLCipherサポートを備えた直接的なSQLite操作
本番環境対応: 組み込みのログ記録、エラー処理、安全機能
⚠️ 重要な安全上の注意
使用前にREKORDBOXライブラリをバックアップしてください
このソフトウェアは、rekordboxデータベースに直接アクセスします。予防措置として、このツールを使用する前に、必ずrekordboxライブラリ全体のバックアップを作成してください。
バックアップ要件
このソフトウェアを使用する前に、rekordboxライブラリの完全なバックアップを作成する必要があります。 お使いの環境やrekordboxのバージョンに応じた適切なバックアップ手順については、rekordboxのドキュメントやサポートリソースを参照してください。
リスクの承認
⚠️ このプロジェクトはrekordboxデータベースに直接アクセスします
⚠️ 自己責任で使用してください - 保証は提供されません
⚠️ メインライブラリで使用する前に、バックアップで十分にテストしてください
⚠️ 開発者は、データの損失や損害に対して責任を負いません
これらのリスクに納得できない場合は、代わりに読み取り専用のXMLエクスポート機能を使用してください。
クイックスタート
前提条件
Python 3.12以上
既存のライブラリを持つrekordbox 6または7がインストールされていること
rekordboxライブラリの完全なバックアップ(上記の安全上の注意を参照)
読み取り専用ツール(検索、統計、履歴)は、rekordboxが開いている間も動作します
書き込みツール(プレイリスト作成、トラック追加、クリーンアップ)は、rekordboxが閉じている必要があります — rekordboxが実行されている間、pyrekordboxはコミットをブロックします
rekordboxデータベースへのアクセス(自動検出をサポート)
インストール
# Install dependencies with uv
uv sync
# Run the server
uv run rekordbox-mcp設定
サーバーは、データベースの自動検出と手動設定の両方をサポートしています:
# Auto-detect rekordbox database (recommended)
uv run rekordbox-mcp
# Specify custom database path
uv run rekordbox-mcp --database-path /path/to/rekordbox/PioneerMCPクライアントの設定
Claude Desktopの設定に追加してください:
{
"mcpServers": {
"rekordbox-database": {
"command": "uv",
"args": ["run", "rekordbox-mcp"],
"cwd": "/path/to/rekordbox-mcp"
}
}
}利用可能なツール(29ツール + 1リソース)
検索と発見
search_tracks- フィルタリング(ジャンル、キー、BPM、アーティスト、タイトル、評価など)を備えた高度な複数フィールドトラック検索get_track_details- IDによる特定のトラックの完全なメタデータを取得get_tracks_by_key- 特定の音楽キー(例: "5A", "12B")のトラックを検索get_tracks_by_bpm_range- BPM範囲内のトラックを検索get_genre_filepaths- ジャンルに一致するトラックのファイルパスを取得(トークン効率的、パスのみを返します)get_most_played_tracks- 再生回数順にランク付けされたトラックを取得get_top_rated_tracks- 評価順にランク付けされたトラックを取得get_unplayed_tracks- 再生回数がゼロのトラックを取得get_track_file_path- 特定のトラックのファイルシステムパスを取得search_tracks_by_filename- 部分的なファイル名一致でトラックを検索
ライブラリ分析
get_library_stats- 包括的なライブラリ統計(トラック数、再生時間、BPM、ジャンル)analyze_library- カスタムグループ化と集計(ジャンル、キー、年、アーティスト、または評価別)validate_track_ids- トラックIDのリストを検証し、有効/無効を報告
プレイリスト操作
get_playlists- スマートプレイリストを含むすべてのプレイリストを一覧表示get_playlist_tracks- 特定のプレイリスト内のすべてのトラックを取得create_playlist- 新しいプレイリストまたはフォルダを作成 ⚠️ (変更)add_track_to_playlist- 単一のトラックをプレイリストに追加 ⚠️ (変更)add_tracks_to_playlist- 1回の操作で複数のトラックをプレイリストに追加 ⚠️ (変更)remove_track_from_playlist- プレイリストからトラックを削除 ⚠️ (変更)delete_playlist- プレイリストを完全に削除 ⚠️ (破壊的)
DJ履歴と分析
get_history_sessions- メタデータを含むすべてのDJ履歴セッションを取得get_session_tracks- 特定のセッションで再生されたすべてのトラックを取得get_recent_sessions- 指定した日数以内のセッションを取得search_history_sessions- 名前、年、月、または最小トラック数でセッションを検索get_history_stats- 包括的なDJパフォーマンス統計とインサイト
ライブラリのクリーンアップ
find_broken_tracks- 見つからないファイル、Apple Musicストリーム、空のパス、孤立したプレイリスト参照をスキャンcleanup_orphaned_playlist_entries- 削除されたトラックを参照している古いプレイリストエントリを削除 ⚠️ (変更)remove_broken_tracks- IDでトラックをソフト削除し、すべてのプレイリストから削除 ⚠️ (破壊的)
データベース管理
connect_database- オプションのカスタムデータベースパスを指定して明示的に接続
リソース
database-status- 現在の接続状態と基本的な統計
⚠️ 変更操作はrekordboxデータベースを変更し、自動バックアップを作成します ⚠️ 破壊的操作はデータを完全に削除するため、追加の確認が必要です
例
キーとBPMによるトラック検索
# Find tracks in 5A key with BPM between 120-130
search_tracks(key="5A", bpm_min=120, bpm_max=130, limit=20)DJ履歴へのアクセス
# Get recent DJ sessions
get_recent_sessions(days=30)
# Get tracks from a specific session
get_session_tracks(session_id="12345")ライブラリインサイトの取得
# Comprehensive library statistics
get_library_stats()
# DJ performance statistics
get_history_stats()プレイリスト管理
# 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")安全機能
自動バックアップ: すべての変更操作は、変更前に自動データベースバックアップを作成します
FastMCP安全注釈: 変更および破壊的操作に対する適切な安全ヒント
スマートプレイリスト保護: インテリジェントプレイリストの削除を防止
接続検証: データベース接続とアクセスを検証
エラー処理: 詳細なログ記録とロールバックを備えた包括的なエラー処理
入力検証: すべてのデータベース操作に対する入力検証
バッチ操作の安全性: バッチ操作の成功/失敗に関する詳細なレポート
⚠️ 重要: これらの安全機能は補助的な保護です。常に独自のバックアップを維持し、自己責任でこのソフトウェアを使用してください。
開発
プロジェクト構造
rekordbox_mcp/
__init__.py # Package initialization
server.py # FastMCP server and tool definitions
database.py # Database connection and operations
models.py # Pydantic data modelsテストの実行
uv run pytestコード品質
# Format code
uv run black rekordbox_mcp/
# Lint code
uv run ruff rekordbox_mcp/
# Type checking
uv run mypy rekordbox_mcp/ライセンス
MITライセンス
免責事項
⚠️ 自己責任で使用してください ⚠️
このプロジェクトは、AlphaTheta (Pioneer DJ) やpyrekordboxプロジェクトとは提携していません
このソフトウェアはrekordboxデータベースに直接アクセスします
いかなる保証も提供されません
開発者は、rekordboxライブラリへのいかなる損害に対しても責任を負いません
このソフトウェアを使用する際は、すべてのリスクを負うものとします
使用前に必ずrekordboxライブラリをバックアップしてください。メインライブラリで使用する前に、バックアップコピーで十分にテストしてください。
このソフトウェアを使用することにより、これらのリスクを理解し、自己責任で使用することに同意したものとみなされます。
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.52 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