Emotion Playlist MCP

🚀 情緒播放列表 MCP

情緒播放列表 MCP 是一款基於 MCP 的實用工具，它能依據用戶當下的情緒狀態，自動生成專屬的 Spotify 歌單。該工具藉助 Brave Search MCP 服務器，精準查找與用戶情緒相關的歌曲，並通過集成 Spotify MCP 服務器，實現歌單的自動創建與填充，為用戶帶來個性化的音樂體驗。

🚀 快速開始

克隆倉庫

git clone https://github.com/yourusername/emotion_playlist_mcp.git
cd emotion_playlist_mcp

設置環境

你可以選擇使用 uv 來快速設置環境：

uv init

若你想手動設置，可按以下步驟操作：

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

配置環境變量

在項目根目錄下創建一個 .env 文件，並按如下格式填寫信息：

SPOTIFY_CLIENT_ID=你的 Spotify 客戶端 ID
SPOTIFY_CLIENT_SECRET=你的 Spotify 客戶端密鑰
SPOTIFY_REDIRECT_URI=http://127.0.0.1:8888/callback  # 必須與 Spotify 開發者應用程序中的重定向 URI 相同
BRAVE_API_KEY=你的 Brave API 密鑰

注意：Spotify 令牌可以在 Spotify 開發者網站上找到，且使用該工具需要你擁有 Spotify 高級賬戶。

生成 Spotify 的授權令牌

運行以下命令來生成 Spotify 的授權令牌：

python3 orchestrator/tools/spotify_auth.py

安裝 MCP 服務器

使用以下命令安裝 MCP 服務器：

mcp install main.py --name EmotionPlaylistMCP   

✨ 主要特性

• 支持用戶輸入自然語言描述自己的情緒。
• 能夠將用戶輸入的情緒信息細化為詳細的搜索短語。
• 藉助 Brave 搜索引擎，精準搜索與細化後情緒相匹配的歌曲建議。
• 自動利用搜索到的歌曲信息，在 Spotify 上創建並填充歌單。

🤝 貢獻

歡迎大家對本項目進行復刻、修改，並提交拉取請求。讓我們攜手合作，讓基於情緒的音樂推薦變得更加智能！

📄 許可證

本項目採用 MIT 許可證。