Spotify MCP

🚀 Spotify-MCP 服务器项目

本项目致力于将Claude与Spotify进行连接，借助spotipy-dev的API构建，为用户提供便捷的音乐控制与管理体验。

✨ 主要特性

• 🎵 控制播放：可轻松实现音乐的开始、暂停和跳过播放操作。
• 🔍 搜索功能：支持搜索歌曲、专辑、艺术家或播放列表。
• ℹ️ 信息获取：能够获取关于歌曲、专辑、艺术家或播放列表的详细信息。
• 📋 队列管理：方便管理Spotify的播放队列。

🎥 演示

请确保音频已开启哦~

📦 安装指南

获取Spotify API密钥

您需要在developer.spotify.com创建一个账户，然后导航到仪表盘。接着创建一个应用，并将redirect_uri设置为http://localhost:8888 （您可以选择任何端口，但必须使用http和localhost）。这里我选择了"APIs used"设为"Web Playback SDK"。

本地运行此项目

该项目目前尚未配置为无须环境的（例如uvx的使用），您可以通过克隆此仓库在本地运行这个项目。

git clone https://github.com/varunneal/spotify-mcp.git

将此工具添加为MCP服务器。在MacOS中，配置文件路径为：~/Library/Application\ Support/Claude/claude_desktop_config.json；在Windows中，配置文件路径为：%APPDATA%/Claude/claude_desktop_config.json%。

"spotify": {
    "command": "uv",
    "args": [
        "--directory",
        "/path/to/spotify_mcp",
        "run",
        "spotify-mcp"
    ],
    "env": {
        "SPOTIFY_CLIENT_ID": 您的_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": 您的_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
    }
}

故障排除

如果无法使用此MCP，请打开问题。以下是一些实用提示：

1. 确保uv已更新，建议版本>=0.54。
2. 确保Claude有执行权限，可使用命令：chmod -R 755。
3. 确保您拥有Spotify Premium（运行开发者API所需的条件）。

此MCP将输出到标准错误流（如MCP规范中所指定的）。在Mac上，Claude Desktop应用程序会在~/Library/Logs/Claude路径下显示日志；在其他平台上，可以在此处找到日志。

📅 待办事项

很遗憾，由于Spotify API的一些功能已被停用，现在有大量酷炫的功能无法实现。后续将主要关注对项目的健康发展：

• 🧪 添加测试。
• 📃 为管理播放列表添加API支持。
• ⏭️ 为搜索结果、播放列表/专辑等的分页添加API支持。

欢迎提交拉取请求！

🚀 部署

打包与发布

准备发行版本的步骤如下：

1. 同步依赖项并更新锁定文件：

uv sync

2. 构建发行版本：

uv build

这将在dist/目录下创建源代码和轮格式分发。 3. 发布到PyPI：

uv publish

注意：您需要通过环境变量或命令行参数设置PyPI凭证：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用户名/密码：--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过标准I/O运行，调试可能具有挑战性。为了获得最佳的调试体验，我们强烈推荐使用MCP Inspector。 您可以通过以下命令启动MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /Users/varun/Documents/Python/spotify_mcp run spotify-mcp

启动后，Inspector会显示一个URL，您可以在浏览器中访问该URL以开始调试。