Spotify Playlist Curator MCP Server

Spotify 播放列表策展 MCP 服务

一个 MCP 服务，可通过分析现有曲目，并使用 Claude AI 根据心情、氛围、BPM 和其他音乐属性推荐歌曲，帮助你策展 Spotify 播放列表。

功能

• 连接你的 Spotify 账户并访问播放列表
• 分析播放列表中曲目的音频特征
• 生成播放列表心情、能量、节奏和其他特征的摘要
• 根据播放列表分析结果获取 Claude AI 推荐的歌曲
• 在 Spotify 上搜索曲目
• 将推荐曲目添加到播放列表
• 创建新的播放列表

设置

前提条件

• Node.js（v14 或更高版本）
• Spotify 开发者账户和已注册的应用
• 通过 MCP（Machine Conversation Protocol）访问 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 添加为 Redirect 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 // Optional, defaults to 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 // Optional, defaults to 10
});

createPlaylist

创建新的 Spotify 播放列表。

const response = await client.createPlaylist({
  name: "My New Playlist",
  description: "Created by Spotify Playlist Curator", // Optional
  isPublic: false // Optional, defaults to false
});

客户端使用示例

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

async function main() {
  // Create MCP client
  const client = createClient({
    serverUrl: 'http://localhost:3000',
    anthropicApiKey: 'your_anthropic_api_key' // Required for Claude integration
  });

  // 1. Get user playlists
  const playlists = await client.getPlaylists();
  console.log('Your playlists:', playlists);

  // 2. Select a playlist and get its details
  const playlistId = playlists.playlists[0].id;
  const playlistDetails = await client.getPlaylistDetails({ playlistId });
  console.log('Playlist summary:', playlistDetails.summary);

  // 3. Get recommendations from Claude
  const recommendations = await client.getClaudeRecommendations({ playlistId });
  console.log('Claude recommendations:', recommendations.claudeRecommendations);

  // 4. Add recommendations to the playlist
  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