金大哥 - Spotify-Playlist-Curator-MCP-Server MCP 详情

article

README

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

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

先决条件

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

安装步骤

克隆此仓库：

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

安装依赖项：
```
npm install
```
基于提供的 .env.example 创建一个 .env 文件：
```
cp .env.example .env
```
设置您的 Spotify 开发者凭证：
- 访问 Spotify 开发者控制台
- 创建一个新的应用程序
- 将 http://localhost:3000/callback 添加为重定向 URI
- 将您的客户端 ID 和客户端密钥复制到 .env 文件中
启动服务器：
```
npm start
```

💻 使用示例

认证

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

在浏览器中访问 http://localhost:3000/login
使用您的 Spotify 账户登录并授权应用程序
成功认证后，可以关闭浏览器窗口并返回到您的 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) 年份，作者姓名。

Spotify-Playlist-Curator-MCP-Server