Spotify 播放列表管理 MCP 服务器

一个 MCP 服务器，通过分析您现有的曲目并使用 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
   • 将您的 Client ID 和 Client Secret 复制到 .env 文件

5. 启动服务器：

   npm start
   

用法

身份验证

当您启动服务器时，您需要首先使用 Spotify 进行身份验证：

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

MCP 方法

以下 MCP 方法可用：

getPlaylists

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

const response = await client.getPlaylists();

getPlaylistDetails

获取有关特定播放列表的详细信息，包括曲目分析。

const response = await client.getPlaylistDetails({
  playlistId: "your_playlist_id"
});

getClaudeRecommendations

根据播放列表分析从 Claude AI 获取歌曲推荐。

const response = await client.getClaudeRecommendations({
  playlistId: "your_playlist_id",
  count: 10 // 可选，默认为 10
});

addRecommendationsToPlaylist

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

const response = await client.addRecommendationsToPlaylist({
  playlistId: "your_playlist_id",
  trackUris: ["spotify:track:id1", "spotify:track:id2", ...]
});

searchTracks

在 Spotify 上搜索曲目。

const response = await client.searchTracks({
  query: "search query",
  limit: 10 // 可选，默认为 10
});

createPlaylist

创建一个新的 Spotify 播放列表。

const response = await client.createPlaylist({
  name: "My New Playlist",
  description: "Created by Spotify Playlist Curator", // 可选
  isPublic: false // 可选，默认为 false
});

客户端使用示例

import { createClient } from '@anthropic-ai/mcp-client';

async function main() {
  // 创建 MCP 客户端
  const client = createClient({
    serverUrl: 'http://localhost:3000',
    anthropicApiKey: 'your_anthropic_api_key' // Claude 集成必需
  });

  // 1. 获取用户播放列表
  const playlists = await client.getPlaylists();
  console.log('Your playlists:', playlists);

  // 2. 选择一个播放列表并获取其详细信息
  const playlistId = playlists.playlists[0].id;
  const playlistDetails = await client.getPlaylistDetails({ playlistId });
  console.log('Playlist summary:', playlistDetails.summary);

  // 3. 从 Claude 获取推荐
  const recommendations = await client.getClaudeRecommendations({ playlistId });
  console.log('Claude recommendations:', recommendations.claudeRecommendations);

  // 4. 将推荐添加到播放列表
  const trackUris = recommendations.claudeRecommendations
    .filter(track => track.matched)
    .map(track => track.uri);
  
  if (trackUris.length > 0) {
    const result = await client.addRecommendationsToPlaylist({ playlistId, trackUris });
    console.log('Added recommendations:', result);
  }
}

main().catch(console.error);

许可证

MIT