Spotify Playlist Curator MCP Server

🚀 Spotify 播放列表策展商 MCP 服务器

本 MCP 服务器可助力您精心策划 Spotify 播放列表。它会对您现有的曲目展开分析，并借助 Claude AI，依据情绪、氛围、BPM 及其他音乐属性，为您推荐契合的歌曲。

🚀 快速开始

启动服务器前，您需完成一系列准备工作，包括安装必要软件、注册开发者账户及设置凭证等。完成后，即可开启 Spotify 播放列表的智能策展之旅。

✨ 主要特性

• 连接您的 Spotify 账户，轻松访问个人播放列表。
• 深入分析播放列表中曲目的音频特征。
• 精准生成播放列表在情绪、能量、节奏等方面特性的总结。
• 基于播放列表分析结果，从 Claude AI 获取个性化歌曲推荐。
• 在 Spotify 上高效搜索心仪的曲目。
• 将推荐的优质曲目便捷添加到播放列表。
• 随心创建全新的播放列表。

📦 安装指南

先决条件

• Node.js（v14 或更高版本）
• 已注册的 Spotify 开发者账户和应用程序
• 通过 MCP 访问 Claude（机器对话协议）

安装步骤

1. 克隆此仓库：

   git clone https://github.com/lechiffre1/Spotify-Playlist-Curator-MCP-Server.git
   cd Spotify-Playlist-Curator-MCP-Server
   

2. 安装依赖项：

   npm install
   

3. 基于提供的 .env.example 创建一个 .env 文件：

   cp .env.example .env
   

4. 设置您的 Spotify 开发者凭证：
   • 访问 Spotify 开发者控制台
   • 创建一个新的应用程序
   • 将 http://localhost:3000/callback 添加为重定向 URI
   • 将您的客户端 ID 和客户端密钥复制到 .env 文件中
5. 启动服务器：

   npm start
   

💻 使用示例

认证

启动服务器后，您需要先进行 Spotify 认证：

1. 在浏览器中访问 http://localhost:3000/login
2. 使用您的 Spotify 账户登录并授权应用程序
3. 成功认证后，可以关闭浏览器窗口并返回到您的 MCP 客户端

MCP 方法

以下 MCP 方法可用：

getPlaylists

返回您 Spotify 播放列表的列表。

const response = await client.getPlaylists();

getPlaylistDetails

根据播放列表 ID 返回详细信息。

const response = await client.getPlaylistDetails('playlist_id');

searchSongs

在 Spotify 上搜索歌曲或艺术家。

const response = await client.searchSongs('artist name');

addSongstoPlaylists

将推荐的曲目添加到播放列表中。

const response = await client.addSongstoPlaylists('playlist_id', ['song_ids']);

示例客户端用法

以下是使用该服务器进行基本操作的示例：

const { Client } = require('./client');

async function main() {
    const client = new Client();
    
    // 获取所有播放列表
    const playlists = await client.getPlaylists();
    console.log('播放列表:', playlists);

    // 获取特定播放列表的详细信息
    const playlistDetails = await client.getPlaylistDetails(playlists[0].id);
    console.log('播放列表详细信息:', playlistDetails);

    // 搜索歌曲
    const searchResults = await client.searchSongs('Taylor Swift');
    console.log('搜索结果:', searchResults);

    // 将歌曲添加到播放列表
    await client.addSongstoPlaylists(playlistDetails.id, ['song_id_1', 'song_id_2']);
    console.log('歌曲已添加到播放列表');
}

main().catch(console.error);

📄 许可证

Spotify 播放列表策展商 MCP 服务器的使用受 MIT 许可证约束。
版权所有 (c) 年份，作者姓名。