Skip to main content
Glama
rekordbox-mcp

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/Pioneer

MCPクライアントの設定

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 tools
add_tracks_to_playlistA
Idempotent

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_playlistA
Idempotent

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_playlistA
DestructiveIdempotent

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_playlistA
Idempotent

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

    A3.5/5.0

    Scored across 25 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers