Spotifymcp

🚀 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

2. 安裝依賴項：

npm install

3. 設置環境變量： 在根目錄下創建一個 .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

2. 在 Claude 配置文件中添加 MCP 服務器配置。
3. 向 Claude 詢問藝術家的名稱。

工具功能

MCP 服務器向 Claude 公開了以下函數：

• get_artist(name)：檢索藝術家的相關信息。

示例交互

用戶："這位藝術家叫什麼名字？"
Claude：[使用 get_artist 函數] "這位藝術家是 Pitbull。"

系統組件說明

• MCP 服務器：處理 Claude 和 Spotify API 之間的通信。
• Spotify API 客戶端：管理對 Spotify 的身份驗證和 API 請求。
• Claude 集成：處理自然語言並確定要調用的函數。