🚀 MCP Claude Spotify 项目指南
本项目可帮助你将 Spotify 集成到 MCP 系统中，实现便捷的音乐控制功能。
🚀 快速开始
该项目能让你轻松地把 Spotify 集成到 MCP 系统里，实现音乐控制功能。下面将为你详细介绍操作步骤。
📦 安装指南
克隆仓库
使用 Git 克隆此仓库：
git clone https://github.com/imprvhub/mcp-claude-spotify.git
cd mcp-claude-spotify
安装依赖
进入仓库目录后，安装项目所需的依赖项：
npm install
🛠️ 配置说明
创建应用
- 访问 Spotify Developer Dashboard
- 点击 "Create Application"
- 填写应用信息：
- Application Name：输入一个名称，例如
MCP Claude Spotify - Description：添加适当的描述
- Redirect URI：添加至少一个 redirect URI，例如
http://localhost:3000/callback（仅适用于开发环境）
- Application Name：输入一个名称，例如
- 完成创建后，记录下你的 Client ID 和 Client Secret。
配置项目
在仓库根目录中创建一个 .env 文件，并添加以下内容：
SPOTIFY_CLIENT_ID=your_client_id_here
SPOTIFY_CLIENT_SECRET=your_client_secret_here
💻 使用示例
认证 Spotify
在 Claude Desktop 中输入以下命令来认证你的 Spotify 账户：
mcp spotify auth
按照提示完成授权流程。完成后，你会在 ~/.spotify-mcp 目录中生成一个 tokens.json 文件，用于存储访问令牌和刷新令牌。
使用工具
以下是可用的 MCP 工具及其命令：
| 命令 | 描述 |
|---|---|
mcp spotify auth |
认证或重新认证 Spotify 账户 |
mcp spotify play |
播放指定的 Spotify 歌曲/播放列表 |
mcp spotify pause |
暂停当前正在播放的音乐 |
mcp spotify resume |
继续播放暂停的音乐 |
mcp spotify next |
跳到下一首歌曲 |
mcp spotify prev |
返回上一首歌曲 |
mcp spotify repeat |
切换重复模式（曲目/列表/关闭） |
mcp spotify shuffle |
切换随机播放模式 |
📁 文件结构
.
├── src/
│ ├── cli.js # MCP 工具的主入口点
│ ├── commands/
│ │ ├── auth.js # 认证命令处理逻辑
│ │ └── player.js # 播放器控制命令处理逻辑
│ └── config.js # 项目配置文件
├── package.json # 项目依赖和脚本
└── .env # 环境变量配置文件
🤝 贡献指南
开发流程
- 克隆仓库
git clone https://github.com/imprvhub/mcp-claude-spotify.git
cd mcp-claude-spotify
- 安装依赖
npm install
- 开发环境 使用以下命令启动开发服务器：
npm run dev
- 测试 在项目根目录中运行：
npm test
代码风格
- 遵循 Node.js 代码规范
- 提供清晰的注释和文档
- 确保代码的一致性和可读性
项目结构
保持以下文件结构：
.
├── src/
│ ├── commands/ # 存放 MCP 命令处理逻辑
│ └── config.js # 项目配置文件
└── package.json # 项目依赖和脚本
提交指南
使用以下命令提交代码：
git add .
git commit -m "你的提交信息"
git push origin main
📄 许可证
此项目遵循 MIT 协议。请查看 LICENSE 文件以获取详细信息。
通过以上步骤，你可以轻松地将 Spotify 集成到 MCP 系统中，并享受音乐控制功能。如需进一步帮助，请参考项目文档或联系维护团队。