使用说明
🎵 Spotify MCP服务器
通过Claude Desktop用自然语言控制Spotify。
75个工具•10个资源
⚡ 快速开始
# 1. Install
pip install -e .
# 2. Authenticate with Spotify
python -m spotify_mcp.auth
# 3. Add to Claude Desktop config (see docs/setup/QUICK_SETUP.md)
📖 完整设置指南： docs/setup/QUICK_setup.md
🎯 你能做什么
自然地说话：
| 类别 | 示例 |
|---|---|
| 回放 | “播放我的每周发现”•“跳过这首歌”•“音量调到50%” |
| 搜索 | “查找冷爵士”•“搜索Radiohead专辑” |
| 图书馆 | “保存此曲目”•“显示我的顶级艺术家” |
| 播放列表 | “创建锻炼播放列表”•“将其添加到我的队列中” |
| 发现 | “本周有什么新消息？”•“展示艺术家的热门曲目” |
🛠️ 工具（75）
| 类别 | 计数 | 描述 |
|---|---|---|
| 播放 | 12 | 播放、暂停、跳过、音量、洗牌、寻道 |
| 播放列表 | 12 | 创建、修改、跟踪、管理封面 |
| 相册 | 8 | 浏览、保存、新发布 |
| 用户 | 8 | 个人资料，热门项目，以下 |
| 节目 | 7 | 播客和剧集 |
| 剧集 | 6 | 保存和管理播客剧集 |
| 艺术家 | 4 | 细节、唱片、热门曲目 |
| 库 | 4 | 保存的曲目管理 |
| 类别 | 2 | 浏览类别 |
| 队列 | 2 | 查看并添加到队列 |
| 曲目 | 2 | 曲目详细信息 |
| 搜索 | 1 | 通用搜索 |
| 市场 | 1 | 可用市场 |
| 复合 | 6 | 多步操作（创建播放列表、分析收听情况） |
注： Spotify的API更改不赞成使用有声读物、章节和流派种子。
📖 完整工具参考： docs/TOOLS.md
📋 需求
- Python 3.10+
- Spotify帐户（用于播放控制的高级版）
- Spotify开发者应用
🔧 配置
克劳德桌面版
窗户： %APPDATA%\Claude\claude_desktop_config.json
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"spotify": {
"command": "python",
"args": ["-m", "spotify_mcp.spotify_server"],
"env": {
"SPOTIFY_CLIENT_ID": "your_client_id",
"SPOTIFY_CLIENT_SECRET": "your_client_secret",
"SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8888/callback",
"PYTHONPATH": "/path/to/spotify_mcp/src"
}
}
}
}
🐛 故障排除
| 问题 | 解决方案 |
|---|---|
ModuleNotFoundError |
设置 PYTHONPATH 到 src 目录 |
| 无令牌 | 运行 python -m spotify_mcp.auth |
| 重定向URI无效 | 使用 127.0.0.1 不 localhost |
| 无活动设备 | 在任何设备上打开Spotify |
| 需要高级版 | 播放控制需要高级版 |
📖 完整指南： docs/setup/故障排除.md
📚 文档
| 文档 | 描述 |
|---|---|
| 快速设置 | 5分钟后开始 |
| 工具参考 | 全部75种工具已解释 |
| api参考 | 资源、提示、模式 |
| 部署 | 生产部署指南 |
| 迁移状态 | FastMCP v3.0实施 |
| 建筑 | 系统设计 |
🚀 发展
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Code quality
black src/ tests/
isort src/ tests/
📄 许可证
MIT许可证-请参阅 许可证
由以下材料制成🎵 AI+音乐社区