金大哥 - mcp-claude-spotify MCP 详情

article

README

🚀 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（仅适用于开发环境）
完成创建后，记录下你的 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 系统中，并享受音乐控制功能。如需进一步帮助，请参考项目文档或联系维护团队。

mcp-claude-spotify