Rekordbox MCP Server 是一个全面的模型上下文协议(MCP)服务器,用于 rekordbox 数据库管理,支持实时数据库访问。
基于 pyrekordbox 构建 - 本项目与 pyrekordbox 项目或其维护者无关联。
# 使用 uv 安装依赖
uv sync
# 运行服务器
uv run rekordbox-mcp
服务器支持自动检测数据库和手动配置:
# 自动检测 rekordbox 数据库(推荐)
uv run rekordbox-mcp
# 指定自定义数据库路径
uv run rekordbox-mcp --database-path /path/to/rekordbox/Pioneer
添加到你的 Claude Desktop 配置中:
{
"mcpServers": {
"rekordbox-database": {
"command": "uv",
"args": ["run", "rekordbox-mcp"],
"cwd": "/path/to/rekordbox-mcp"
}
}
}
# 按调性和 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 许可证。
⚠️ 使用风险自负 ⚠️
使用前请始终备份你的 rekordbox 音乐库。在主音乐库上使用前,请使用备份副本进行全面测试。
使用此软件即表示你已了解这些风险,并同意自行承担使用责任。