MCP Claude Spotify

🚀 MCP Claude Spotify 項目指南

本項目旨在幫助用戶將 Spotify 集成到 MCP 系統中，實現便捷的音樂控制功能，讓用戶輕鬆享受音樂體驗。

🚀 快速開始

安裝

克隆倉庫

使用 Git 克隆此倉庫：

git clone https://github.com/imprvhub/mcp-claude-spotify.git
cd mcp-claude-spotify

安裝依賴

進入倉庫目錄後，安裝項目所需的依賴項：

npm install

配置

創建應用

1. 訪問 Spotify Developer Dashboard
2. 點擊 "Create Application"
3. 填寫應用信息：
   • Application Name：輸入一個名稱，例如 MCP Claude Spotify
   • Description：添加適當的描述
   • Redirect URI：添加至少一個 redirect URI，例如 http://localhost:3000/callback（僅適用於開發環境）
4. 完成創建後，記錄下你的 Client ID 和 Client Secret。

配置項目

在倉庫根目錄中創建一個 .env 文件，並添加以下內容：

SPOTIFY_CLIENT_ID=your_client_id_here
SPOTIFY_CLIENT_SECRET=your_client_secret_here

使用

認證 Spotify

在 Claude Desktop 中輸入以下命令來認證你的 Spotify 賬戶：

mcp spotify auth

按照提示完成授權流程。完成後，你會在 ~/.spotify-mcp 目錄中生成一個 tokens.json 文件，用於存儲訪問令牌和刷新令牌。

使用工具

以下是可用的 MCP 工具及其命令：

📦 安裝指南

克隆倉庫

git clone https://github.com/imprvhub/mcp-claude-spotify.git
cd mcp-claude-spotify

安裝依賴

npm install

📚 詳細文檔

文件結構

.
├── src/
│   ├── cli.js          # MCP 工具的主入口點
│   ├── commands/
│   │   ├── auth.js     # 認證命令處理邏輯
│   │   └── player.js   # 播放器控制命令處理邏輯
│   └── config.js       # 項目配置文件
├── package.json        # 項目依賴和腳本
└── .env                # 環境變量配置文件

貢獻指南

開發流程

1. 克隆倉庫

git clone https://github.com/imprvhub/mcp-claude-spotify.git
cd mcp-claude-spotify

2. 安裝依賴

npm install

3. 開發環境 使用以下命令啟動開發服務器：

npm run dev

4. 測試 在項目根目錄中運行：

npm test

代碼風格

• 遵循 Node.js 代碼規範
• 提供清晰的註釋和文檔
• 確保代碼的一致性和可讀性

項目結構

保持以下文件結構：

.
├── src/
│   ├── commands/       # 存放 MCP 命令處理邏輯
│   └── config.js      # 項目配置文件
└── package.json        # 項目依賴和腳本

提交指南

使用以下命令提交代碼：

git add .
git commit -m "你的提交信息"
git push origin main

📄 許可證

此項目遵循 MIT 協議。請查看 LICENSE 文件以獲取詳細信息。

通過以上步驟，你可以輕鬆地將 Spotify 集成到 MCP 系統中，並享受音樂控制功能。如需進一步幫助，請參考項目文檔或聯繫維護團隊。