MCP Claude Spotify

🚀 MCP Claude Spotify 项目指南

本项目可帮助你将 Spotify 集成到 MCP 系统中，实现便捷的音乐控制功能。

🚀 快速开始

该项目能让你轻松地把 Spotify 集成到 MCP 系统里，实现音乐控制功能。下面将为你详细介绍操作步骤。

📦 安装指南

克隆仓库

使用 Git 克隆此仓库：

git clone https://github.com/imprvhub/mcp-claude-spotify.git
cd mcp-claude-spotify

安装依赖

进入仓库目录后，安装项目所需的依赖项：

npm install

🛠️ 配置说明

创建应用

1. 访问 Spotify Developer Dashboard
2. 点击 "Create Application"
3. 填写应用信息：
   • Application Name：输入一个名称，例如 MCP Claude Spotify
   • Description：添加适当的描述
   • Redirect URI：添加至少一个 redirect URI，例如 http://localhost:3000/callback（仅适用于开发环境）
4. 完成创建后，记录下你的 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 工具及其命令：

📁 文件结构

.
├── src/
│   ├── cli.js          # MCP 工具的主入口点
│   ├── commands/
│   │   ├── auth.js     # 认证命令处理逻辑
│   │   └── player.js   # 播放器控制命令处理逻辑
│   └── config.js       # 项目配置文件
├── package.json        # 项目依赖和脚本
└── .env                # 环境变量配置文件

🤝 贡献指南

开发流程

1. 克隆仓库

git clone https://github.com/imprvhub/mcp-claude-spotify.git
cd mcp-claude-spotify

2. 安装依赖

npm install

3. 开发环境 使用以下命令启动开发服务器：

npm run dev

4. 测试 在项目根目录中运行：

npm test

代码风格

• 遵循 Node.js 代码规范
• 提供清晰的注释和文档
• 确保代码的一致性和可读性

项目结构

保持以下文件结构：

.
├── src/
│   ├── commands/       # 存放 MCP 命令处理逻辑
│   └── config.js      # 项目配置文件
└── package.json        # 项目依赖和脚本

提交指南

使用以下命令提交代码：

git add .
git commit -m "你的提交信息"
git push origin main

📄 许可证

此项目遵循 MIT 协议。请查看 LICENSE 文件以获取详细信息。

通过以上步骤，你可以轻松地将 Spotify 集成到 MCP 系统中，并享受音乐控制功能。如需进一步帮助，请参考项目文档或联系维护团队。