Spotify批量操作MCP
用于批量Spotify操作的模型上下文协议（MCP）服务器- 批量播放列表创建、库导出和大规模库管理。
这与其他Spotify MCP有何不同？
- 信心评分 -批量搜索为每个匹配返回高/中/低置信度
- 循环中的人类 -导出不确定的匹配项以供审查，然后重新导入
- 批量操作 -内置限速功能，高效处理500多首歌曲
- 库导出 -导出完整的库数据
- 播客播放列表聚焦 -专为从播客节目笔记导入歌曲列表而构建
______________________________________________________________________
支持这个项目
因为我不能戴耳机，所以支持我的80k+pocast订阅。 
______________________________________________________________________
上市时间
| 目录 | 链接 |
|---|---|
| PyPI | pypi.org/project/spotify-bulk actions-mcp |
| mcp.so | mcp.so/server/potify-bulk actions-mcp |
| 很棒的mcp服务器 | 产品编号1541 *（待定）* |
______________________________________________________________________
我用它构建的项目
| 项目 | 描述 | 链接 |
|---|---|---|
| 节日导航 | 与朋友一起度过多日的节日 | 仓库 |
使用此MCP维护的播放列表
*即将推出：打开流行音乐、This American Life和更多播客播放列表*
______________________________________________________________________
这有什么作用
图书馆分析：
- 获取您关注的所有艺术家
- 获取所有已保存/喜欢的歌曲（最多可处理10000首歌曲）
- 从您的音乐库中查找按歌曲数量排名的独特艺术家
- 查找您保存了6+首歌曲的专辑（非常适合购买黑胶唱片！）
- 导出完整的库摘要
批量播放列表创建：
- 从CSV文件导入歌曲列表（用于播客播放列表等）
- 带置信度评分的批量搜索（高/中/低）
- 自动处理不确定匹配以供人工审核
- 根据搜索结果创建播放列表
快速开始
1.先决条件
- Python 3.10+
- Spotify帐户
- Spotify开发者证书(把他们带到这儿来)
2.克隆和设置
# Clone the repo
git clone https://github.com/khglynn/spotify-bulk-actions-mcp.git
cd spotify-bulk-actions-mcp
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install the package
pip install -e .
# Copy env example and add your credentials
cp .env.example .env
# Edit .env with your SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET关于PyPI：pip install spotify-bulk-actions-mcp-但你仍然需要本地.env以及身份验证设置。
3.使用Spotify进行身份验证（一次）
这将打开一个浏览器供您登录：
python setup_auth.py登录后，您的令牌将保存在本地 .spotify_cache/.
4.测试它是否有效
source venv/bin/activate
python -c "from src.utils.auth import is_authenticated; print('Auth OK!' if is_authenticated() else 'Not authenticated')"5.连接到克劳德代码
将此添加到您的Claude代码设置中(~/.claude/settings.local.json):
{
"mcpServers": {
"spotify": {
"command": "/path/to/spotify-bulk-actions-mcp/venv/bin/python",
"args": ["/path/to/spotify-bulk-actions-mcp/src/server.py"]
}
}
}添加此代码后重新启动Claude Code。
可用工具（18）
图书馆分析
| 工具 | 说明 |
|---|---|
check_auth_status | 验证Spotify身份验证是否正常工作 |
get_followed_artists | 获取您关注的所有艺术家 |
get_saved_tracks | 获取您喜欢的所有歌曲 |
get_library_artists | 保存歌曲中的艺术家，按数量排名 |
get_albums_by_song_count | 包含N+首已保存歌曲的专辑 |
export_library_summary | 完成库导出 |
搜索
| 工具 | 说明 |
|---|---|
search_track | 搜索单曲 |
search_track_fuzzy | 精确失败时进行更广泛的搜索 |
batch_search_tracks | 搜索许多有信心分数的曲目 |
get_track_preview_url | 获取30秒预览URL |
播放列表
| 工具 | 说明 |
|---|---|
create_playlist | 创建新的播放列表 |
add_tracks_to_playlist | 将曲目添加到现有播放列表 |
import_and_create_playlist | 完整CSV→ 播放列表工作流 |
create_playlist_from_search_results | 从批量搜索创建 |
add_reviewed_tracks | 添加已审核/更正的曲目 |
get_playlist_info | 获取播放列表详细信息 |
公用事业
| 工具 | 说明 |
|---|---|
parse_song_list_csv | 验证歌曲CSV |
export_review_csv | 导出不确定的匹配项以供审查 |
示例工作流
获取您的图书馆统计数据
问克劳德：
“我从哪些艺术家那里保存了最多的歌曲？”
克劳德将使用 get_library_artists 并向您展示。
查找乙烯基专辑
问克劳德：
“查找我保存了6首或更多歌曲的专辑”
克劳德将使用 get_albums_by_song_count 和 min_songs=6.
从歌曲列表创建播放列表
- 创建CSV文件：
title,artist
Bohemian Rhapsody,Queen
Hotel California,Eagles
Billie Jean,Michael Jackson- 问克劳德：
“从此CSV创建一个名为“My Mix”的播放列表：\[粘贴CSV\]”
克劳德将：
- 解析CSV
- 用信心评分搜索每首歌
- 创建具有高置信度匹配的播放列表
- 显示不确定的匹配项以供查看
批量播客播放列表
对于大型列表（500+首歌曲）：
- 请克劳德使用
batch_search_tracks与您的歌曲列表 - 查看结果（HIGH自动进入）
- 使用
export_review_csv获得不确定的匹配 - 在电子表格中查看/更正
- 使用
add_reviewed_tracks添加您的更正
速率限制
服务器自动处理Spotify的速率限制：
- API调用之间的小延迟
- 自动重试429个错误
- 缓存以减少重复调用
对于10000首歌曲，预计初始库获取需要2-3分钟。
文件和数据
| 地点 | 目的 |
|---|---|
.env | 您的Spotify凭据（gitignored） |
.spotify_cache/ | 身份验证令牌和缓存数据（gitignored） |
src/server.py | 主MCP服务器 |
src/tools/ | 工具实施 |
故障排除
“未通过身份验证”错误：
python setup_auth.py速率限制错误： 请稍候几分钟，然后重试。服务器将自动重试。
令牌已过期： 服务器自动刷新令牌。如果问题仍然存在，请重新运行 setup_auth.py.
安全须知
- 您的凭据已在
.env（被忽视，从未承诺） - 身份验证令牌存储在本地
.spotify_cache/ - 永远不要分享你的
.env或令牌文件 - 如果凭据被暴露，请在Spotify仪表板中轮换它们
许可证
麻省理工学院
______________________________________________________________________
因为我不能不戴耳机。如果这对你有帮助的话， 请我喝杯咖啡!