g2dgaming
服务介绍
spotify-mcp MCP 服务器
用于将 Claude 与 Spotify 连接的 MCP 项目。基于 spotipy-dev 的 API 构建。
功能
- 开始、暂停和跳过播放
- 搜索曲目/专辑/艺术家/播放列表
- 获取关于曲目/专辑/艺术家/播放列表的信息
- 管理 Spotify 队列
- 管理、创建和更新播放列表
演示
请确保打开音频
配置
获取 Spotify API 密钥
在 developer.spotify.com 上创建一个账户。导航到 仪表板。
创建一个应用，重定向 URI 设置为 http://127.0.0.1:8080/callback。
您可以选择任何端口，但必须使用 http 和明确的回环地址（IPv4 或 IPv6）。
有关更多信息/故障排除，请参阅 这里。
您可能需要重启您的 MCP 环境（例如 Claude Desktop）一两次才能使其正常工作。
本地运行此项目
此项目尚未设置为临时环境（例如 uvx 使用）。
通过克隆此仓库来本地运行此项目
bash
git clone https://github.com/varunneal/spotify-mcp.git
将此工具添加为 MCP 服务器。
MacOS 上的 Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows 上的 Claude Desktop: %APPDATA%/Claude/claude_desktop_config.json
json
"spotify": {
"command": "uv",
"args": [
"--directory",
"/path/to/spotify_mcp",
"run",
"spotify-mcp"
],
"env": {
"SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
"SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
"SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
}
}
故障排除
如果您无法使此 MCP 正常工作，请打开一个问题。以下是一些提示：
- 确保
uv已更新。我推荐版本>=0.54。 - 确保 claude 对项目的执行权限：
chmod -R 755。 - 确保您有 Spotify 会员资格（运行开发者 API 所需）。
此 MCP 将日志输出到标准错误（如 MCP 规范中所述）。在 Mac 上，Claude Desktop 应用程序应将这些日志输出到 ~/Library/Logs/Claude。
在其他平台上您可以在这里找到日志。
您可以使用 npm 启动 MCP Inspector，命令如下：
bash
npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp
启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。
待办事项
不幸的是，Spotify API 中许多很酷的功能现在已被弃用。
大多数新功能将相对较小或为了项目的健康：
- 测试。
- 添加对管理播放列表的 API 支持。
- 添加对分页搜索结果/播放列表/专辑的 API 支持。
欢迎提交 PR！感谢 @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj 及其他人的贡献。
部署
（待定）
构建和发布
准备包进行分发：
- 同步依赖项并更新锁文件：
bash
uv sync
- 构建包分发：
bash
uv build
这将在 dist/ 目录中创建源码和 wheel 分发。
- 发布到 PyPI：
bash
uv publish
注意：您需要通过环境变量或命令标志设置 PyPI 凭证：
- 令牌：
--token或UV_PUBLISH_TOKEN - 或用户名/密码：
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
