JinDaGe - SpotifyMCP MCP Details

article

README

🚀 Spotify-Claude MCP Server

这是一款连接 Spotify API 并使用 Claude 作为 AI 助手的工具，旨在增强音乐发现和互动体验。它能让用户通过自然语言查询与 Spotify 账户进行交互，为音乐爱好者带来更智能、便捷的音乐探索之旅。

🚀 快速开始

本项目通过模型控制协议（MCP）服务器将 Claude AI 与 Spotify API 集成。用户可以使用 Claude 处理后的自然语言查询与自己的 Spotify 账户进行交互。

✨ 主要特性

目前，Claude 可以利用 Spotify API 获取艺术家信息。后续还可扩展到其他查询功能，例如获取热门曲目、音乐流派、创建播放列表或获取用户个人资料数据等。

📦 安装指南

前提条件

Spotify 开发者账户
Spotify API 凭证（客户端 ID 和客户端密钥）
Claude 桌面版

安装步骤

克隆仓库：

git clone https://github.com/DivyamAgg24/SpotifyMCP.git
cd SpotifyMCP

安装依赖项：

npm install

设置环境变量：在根目录下创建一个 .env 文件，并设置以下变量：

SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_ACCESS_TOKEN=access_token_obtained_from_clientId_and_clientSecret

📚 详细文档

配置

在 Spotify 开发者控制台注册你的应用。
在 Spotify 应用设置中添加 http://localhost:8888/callback 作为重定向 URI。
将客户端 ID 和客户端密钥复制到你的 .env 文件中。

使用方法

构建项目：

tsc -b

在 Claude 配置文件中添加 MCP 服务器配置。
向 Claude 询问艺术家的名称。

工具功能

MCP 服务器向 Claude 公开了以下函数：

get_artist(name)：检索艺术家的相关信息。

示例交互

用户："这位艺术家叫什么名字？"
Claude：[使用 get_artist 函数] "这位艺术家是 Pitbull。"

系统组件说明

MCP 服务器：处理 Claude 和 Spotify API 之间的通信。
Spotify API 客户端：管理对 Spotify 的身份验证和 API 请求。
Claude 集成：处理自然语言并确定要调用的函数。

SpotifyMCP