返回 MCP 目录
public公开dns本地运行

SpotifyMCP

一个通过MCP服务器将Claude AI与Spotify API集成的工具,支持用户使用自然语言查询与Spotify账户交互,实现增强的音乐发现和互动功能。

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 桌面版

安装步骤

  1. 克隆仓库:
git clone https://github.com/DivyamAgg24/SpotifyMCP.git
cd SpotifyMCP
  1. 安装依赖项:
npm install
  1. 设置环境变量: 在根目录下创建一个 .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 文件中。

使用方法

  1. 构建项目:
tsc -b
  1. 在 Claude 配置文件中添加 MCP 服务器配置。
  2. 向 Claude 询问艺术家的名称。

工具功能

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

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

示例交互

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

系统组件说明

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端