Rekordbox MCP

🚀 Rekordbox MCP Server

Rekordbox MCP Server 是一個全面的模型上下文協議（MCP）服務器，用於 rekordbox 數據庫管理，支持即時數據庫訪問。

基於 pyrekordbox 構建 - 本項目與 pyrekordbox 項目或其維護者無關聯。

🚀 快速開始

前提條件

• Python 3.12 及以上版本
• 安裝了 rekordbox 6 或 7 並已有音樂庫
• 完整備份你的 rekordbox 音樂庫（詳見下方重要安全提示）
• 使用此工具時，rekordbox 必須完全關閉
• 能夠訪問你的 rekordbox 數據庫（支持自動檢測）

安裝

# 使用 uv 安裝依賴
uv sync

# 運行服務器
uv run rekordbox-mcp

配置

服務器支持自動檢測數據庫和手動配置：

# 自動檢測 rekordbox 數據庫（推薦）
uv run rekordbox-mcp

# 指定自定義數據庫路徑
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"
    }
  }
}

✨ 主要特性

🗄️ 數據庫訪問

• 直接連接 SQLite 數據庫：使用 pyrekordbox 直接訪問加密的 rekordbox 數據庫
• 即時查詢：通過綜合條件搜索和過濾曲目
• 安全的修改操作：管理播放列表，自動備份並提供安全註解

🔍 搜索與發現

• 高級搜索：可在藝術家、標題、流派、調性、BPM 等多個字段進行搜索
• 音樂調性過濾：查找適合和聲混音的同調曲目
• BPM 範圍查詢：按節奏範圍搜索以進行節拍匹配
• 評分和播放次數過濾：發現你最喜愛和播放次數最多的曲目

📊 分析與洞察

• 音樂庫統計：提供包括流派分佈、平均 BPM、總播放時間等全面統計信息
• 播放次數分析：跟蹤收聽模式和習慣
• 音樂庫洞察：瞭解你的音樂庫構成
• DJ 歷史訪問：全面訪問你的 DJ 演出歷史和表現數據

⚙️ 數據庫操作

• 播放列表管理：安全地創建、修改和刪除播放列表
• 批量操作：高效地將多首曲目添加到播放列表
• 歷史分析：訪問完整的 DJ 演出歷史和表現數據
• 音樂庫統計：提供全面的分析和洞察

🔧 技術細節

架構

• FastMCP 框架：使用 FastMCP 2.0 的現代 Python MCP 服務器
• pyrekordbox 集成：成熟的加密數據庫訪問庫
• 即時數據庫查詢：支持 SQLCipher 的直接 SQLite 操作
• 生產就緒：內置日誌記錄、錯誤處理和安全功能

💻 使用示例

基礎用法

# 按調性和 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")

⚠️ 重要提示

⚠️ 重要提示

本軟件直接訪問你的 rekordbox 數據庫進行分析和查詢。雖然目前為只讀模式，但作為預防措施，使用此工具前請始終備份你的整個 rekordbox 音樂庫。

你應該在使用此軟件前完整備份你的 rekordbox 音樂庫。請參考 rekordbox 文檔或支持資源，瞭解適合你特定設置和 rekordbox 版本的正確備份程序。

• ⚠️ 本項目直接訪問你的 rekordbox 數據庫
• ⚠️ 使用風險自負 - 不提供任何保證
• ⚠️ 在主音樂庫上使用前，請使用備份進行全面測試
• ⚠️ 開發者對任何數據丟失或損壞不承擔責任

如果你對這些風險感到不安，請使用只讀 XML 導出功能。

📄 許可證

本項目採用 MIT 許可證。

免責聲明

⚠️ 使用風險自負 ⚠️

• 本項目與 AlphaTheta（Pioneer DJ）或 pyrekordbox 項目無關聯
• 本軟件直接訪問你的 rekordbox 數據庫
• 不提供任何保證或擔保
• 開發者對任何損壞你的 rekordbox 音樂庫的情況不承擔責任
• 使用此軟件時，你需承擔所有風險

使用前請始終備份你的 rekordbox 音樂庫。在主音樂庫上使用前，請使用備份副本進行全面測試。

使用此軟件即表示你已瞭解這些風險，並同意自行承擔使用責任。