Spotify Mcpb

Spotify MCPB（注：MCPB可能是一个特定项目、计划或品牌的缩写，具体含义需根据上下文确定，此处直接音译）

Control Spotify and create custom playlists using the Spotify Web API through Claude Desktop.

Cross-platform support for Windows, macOS, and Linux.

Quick Start • Features • Installation • Tools • Documentation • Contributing

______________________________________________________________________

🎵 让Claude成为你的私人Spotify DJ！ 基于 Spotify-DXT 由Kenneth Lien（连肯尼斯）所著/创作 使用Spotify Web API进行了跨平台兼容性重写

🌟 为什么选择Spotify MCPB？

• 🤖 人工智能驱动控制 - 通过Claude Desktop使用自然语言控制Spotify
• 🎨 智能播放列表 - 利用AI辅助创建和管理播放列表
• 🔍 深入分析 - 获取详细的音频特征分析和统计数据
• ⚡ 轻松设置 - 简单的令牌生成脚本 - 无需复杂的OAuth
• 🌍 跨平台 - 适用于Windows、macOS和Linux系统
• 🔌 22种工具 - 全面的Spotify控制和管理
• 📦 一键安装 - MCPB 打包格式，用于即时部署

✨ 你能做什么？

You: "What's playing on Spotify?"
Claude: Shows currently playing track with artist and album info

You: "Play some upbeat jazz music"
Claude: Searches for jazz tracks and starts playing them instantly

You: "Create a workout playlist with high-energy tracks"
Claude: Searches for energetic songs and creates a custom playlist

You: "Play my workout playlist"
Claude: Finds and plays your workout playlist immediately

You: "Analyze my Discover Weekly and tell me the vibe"
Claude: Provides audio feature analysis with energy, danceability, mood stats

You: "Skip to the next track and turn up the volume"
Claude: Controls playback instantly

🎵 增强智能播放功能

新的 智能播放 该功能使得控制Spotify变得比以往更加直观：

🔄 恢复播放

You: "Play"
Claude: Resumes your current playback instantly

🎶 通过搜索播放音乐

You: "Play some chill indie rock"
Claude: Searches for indie rock tracks and starts playing the top results

You: "Play tracks by The Beatles"
Claude: Finds Beatles songs and starts a Beatles listening session

📝 按名称播放播放列表

You: "Play my workout playlist"
Claude: Searches your playlists and plays your workout mix

You: "Play Discover Weekly"
Claude: Finds and plays your Discover Weekly automatically

🧠 上下文感知式游玩

You: Create a playlist called "Study Music"
Claude: Creates the playlist successfully
You: "Play Study Music"
Claude: Recognizes the recently created playlist and plays it immediately

智能播放功能会根据您的查询自动检测您想要的内容——无需指定您是想要单曲还是播放列表！

🚀 快速入门

对于用户（最简单）

1. 下载 来自（某处/某人）的最新套餐/集合 发布
2. 获取凭证 来自 Spotify开发者仪表板
3. 生成令牌跑 npm run get-token 在项目目录中获取您的刷新令牌
4. 安装软件包双击 spotify-mcpb-0.2.4.mcpb 并输入所有三个凭证
5. 开始使用： _“Spotify上在播放什么？”_ 🎵

⏱️ 设置时间：约5分钟 | 查看 SETUP.md 翻译为中文是：“安装设置指南.md” 或 “安装配置文件.md”（具体翻译可能根据上下文有所调整，但通常“SETUP.md”指的是一个关于如何设置或安装软件的Markdown文档） 以获取详细说明

对于开发者

# Clone and install
git clone https://github.com/fabioc-aloha/spotify-mcpb.git
cd spotify-mcpb
npm install

# Configure credentials
cp .env.example .env
# Edit .env with your Spotify API credentials

# Run locally
npm start

# Build bundle (optional)
npm install -g @anthropic-ai/mcpb
mcpb pack . spotify-mcpb-0.2.4.mcpb

看见 BUNDLE.md 翻译为中文是：“捆绑包.md” 或者根据上下文，也可以理解为“打包文件.md”，但“捆绑包”更为常用 以获取完整的构建说明。

🎯 功能

🎮 播放控制

• 智能游玩 - 智能播放功能，可：

- 恢复播放（无参数） - 播放搜索结果（查询词：“播放爵士音乐”） - 按名称播放播放列表（“播放我的锻炼播放列表”） - 上下文感知播放列表检测（记住最近创建的播放列表）

• 跳过曲目 - 下一曲/上一曲导航
• 音量控制 - 设置音量级别（0-100）
• 播放信息 - 获取当前曲目和完整的播放状态

🔍 搜索与发现

• 目录搜索 - 搜索数百万首曲目
• AI推荐 - 根据以下内容获取智能轨迹建议：

- 音频特征（能量、舞曲性、节奏、情绪） - 种子曲目、艺术家或流派 - 可定制的目标和范围

📝 播放列表管理

• 创建播放列表 - 创建带有自定义名称/描述的新播放列表
• 添加音轨 - 智能轨道添加，自动去重
• 查看播放列表 - 获取详细的播放列表信息
• 列出用户播放列表 - 浏览你所有的播放列表

🎵 用户图书馆管理

• 喜欢的歌曲 - 访问并管理您保存的曲目
• 保存/删除音轨 - 在你的库中添加或删除曲目
• 图书馆状态 - 检查轨迹是否已保存
• 已保存的专辑 - 浏览和管理您保存的相册

📊 音频分析

• 轨道特性 - 获取详细的音频特性：

- 音质（或“声音的纯净度”）、舞曲性、能量、愉悦度 - 节拍、调式、模式、拍号 - 响度、语音性、乐器性

• 播放列表分析 - 综合统计数据：

- 所有特征的均值、标准差、最小值/最大值 - 总时长和曲目数量 - 多样性得分（变异系数）

🔐 交互式设置

• OAuth 流程 - 内置令牌生成（无需手动脚本！）
• 安全存储 - 凭据通过环境变量进行管理
• 自动刷新 - 自动令牌续期

📋 要求

播放控制所需的高级权限 | Spotify 开发者应用 | 自由创作于 developer.spotify.com 翻译为中文是“Spotify开发者网站” | | Claude Desktop（可译为“Claude桌面版”或保持原样，具体取决于语境和是否需要强调其为桌面应用程序） | 一键安装软件包 | | Node.js | ≥18.0.0（仅限开发使用） |

📦 安装

🛠️ 可用工具（共22个）

设置与身份验证

1. spotify_get_refresh_token - 交互式OAuth流程（无需手动脚本！）

播放控制

1. spotify_play - 智能播放功能：继续播放（无参数），播放搜索结果（带查询），或按名称播放播放列表
2. spotify_play_playlist - 通过名称或ID播放特定播放列表
3. spotify_pause - 暂停播放
4. spotify_next_track - 跳到下一首曲目
5. spotify_previous_track - 跳转到上一曲
6. spotify_set_volume - 设置音量（0-100）

曲目信息 & 搜索

1. spotify_get_current_track - 获取当前播放的曲目
2. spotify_get_playback_state - 获取完整的播放状态
3. spotify_search_tracks - 搜索Spotify目录

播放列表管理

1. spotify_create_playlist - 创建新播放列表
2. spotify_add_tracks_to_playlist - 添加轨道并进行去重
3. spotify_get_playlist - 获取播放列表详情
4. spotify_get_user_playlists - 列出用户的播放列表

用户图书馆管理

1. spotify_get_saved_tracks - 获取用户保存的曲目（喜欢的歌曲）
2. spotify_save_tracks - 将曲目保存到库中（添加到喜欢的歌曲）
3. spotify_remove_saved_tracks - 从库中移除曲目
4. spotify_check_saved_tracks - 检查曲目是否已保存在库中
5. spotify_get_saved_albums - 获取用户保存的专辑

建议与分析

1. spotify_get_recommendations - 获取轨道推荐
2. spotify_get_audio_features - 获取曲目的音频特征
3. spotify_analyze_playlist - 分析播放列表统计数据

📚 文档

🤝 贡献

欢迎投稿！以下是您可以提供帮助的方式：

• 🐛 表示“虫子”或“错误（bug）”，在中文中可以翻译为“虫子”或根据上下文翻译为“错误”。 报告错误： 打开一个议题/问题
• 💡 灵感/想法/智慧之光 建议功能在问题中分享你的想法
• 📖 书籍 改进文档提交文档的拉取请求（PRs）
• 🔧 修理工具或螺丝刀的符号，常用于表示需要修理或调整的物品或情况。 提交代码克隆（或复制）仓库，创建一个分支，然后提交一个拉取请求（PR）

📊 项目统计

• 包大小3.0 MB（压缩后）
• 总文件数1,767+ 个文件
• 依赖项60个制作套件
• 代码质量0个漏洞
• MCP 工具22种综合工具
• API合规100%（2025年10月已验证）

🔗 相关项目

• Spotify-DXT（注：DXT可能是一个特定功能、扩展或技术的缩写，但在此上下文中未给出具体含义，因此直接音译为“DXT”） - 原始仅适用于macOS的版本，由Kenneth Lien开发
• MCP SDK（MCP软件开发工具包） - 模型上下文协议SDK
• Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文判断是否需要具体翻译） - 支持MCP的人工智能助手
• MCPB规范 - MCP（多芯片模块）包规范

🙏 致谢

• 连 Kenneth（或根据具体语境可译为“连肯尼斯”） - 原版 Spotify-DXT（注：这里的“DXT”可能是一个特定上下文或项目中的缩写或特定功能的名称，由于没有具体上下文，直接翻译为“Spotify-DXT”以保持原样） 项目
• Anthropic（注：Anthropic是一个人工智能公司名称，直接翻译为“人类中心论的”或“以人为本的”在此上下文中并不合适，因为这里指的是公司名，所以通常直接保留原名或根据具体语境进行适当解释，但在此直接给出音译加注释的翻译形式） - MCPB规范和Claude Desktop
• Spotify（音乐流媒体服务平台） - Web API和开发者平台
• MCP 社区 - 模型上下文协议生态系统

📄 许可证

MIT 许可证 - 详见 LICENSE.md（许可证文件）

太长，读不下去了可自由使用、修改和分发。只需保留许可声明。

💬 支持

• 问题：
• 讨论:
• Spotify API: 开发者文档
• MCP协议： 官方文档

⭐ 表达你的支持

如果你觉得这个项目很有用，请考虑：

• ⭐ 主演 存储库
• 🐦 翅膀（或鸟） 分享 在社交媒体上
• 🔗（这个符号在中文里通常表示链接或连接，但没有具体的上下文，所以只能翻译为“链接”或保持原样作为符号使用） 链接 来自你的项目
• 🤝（握手） 贡献 改进

______________________________________________________________________

Made with ❤️ by Fabio Correa

Based on the original macOS-only spotify-dxt, reimagined for cross-platform use

Download Latest Release →