Playlist MCP Server

🚀 情境模型提供者（MCP）播放列表生成器

本項目是一個專為Claude或其他支持工具使用的AI助手打造的情境模型提供者（MCP）服務器。它能依據用戶當下的心情或主題，在本地計算機上生成.m3u播放列表，並將其保存至用戶指定目錄，方便用戶隨時在喜愛的媒體播放器中播放。

🚀 快速開始

本項目使用Python構建，由uv和mutagen驅動，其靈感源自傳奇的文件系統MCP服務器。以下為您介紹如何快速開啟使用：

1. 安裝必要的依賴：

pip install uv mutagen

2. 克隆此倉庫並運行服務器：

uvicorn mcp_server:app --reload

3. 向Claude發送提示，例如：“嘿Claude，你能為我創建一個快樂心情的播放列表嗎？”Claude會藉助MCP服務器工具生成播放列表，之後您就能在音樂應用程序中找到它。

⚠️ 重要提示

創建播放列表後請確保重新索引您的Music應用程序。

✨ 主要特性

• 依據用戶心情或主題生成.m3u播放列表。
• 掃描本地音樂文件，利用mutagen讀取元數據，精準過濾匹配心情的歌曲。
• 支持與Claude等AI助手集成，方便用戶操作。

📦 安裝指南

安裝依賴

pip install uv mutagen

運行服務器

克隆此倉庫並運行以下命令：

uvicorn mcp_server:app --reload

💻 使用示例

基礎用法

向Claude發送如下提示：

“嘿Claude，你能為我創建一個快樂心情的播放列表嗎？”

Claude會調用MCP服務器工具，隨後您將在音樂應用程序中獲得相應的播放列表。

🔧 技術細節

工作原理

1. 用戶設置MCP服務器：使用Python和uv搭建服務器。
2. 監聽請求：服務器監聽來自Claude或其他LLM代理的請求。
3. 生成播放列表：根據請求（如“創建一個輕鬆的晚上播放列表”），執行以下操作：
   • 掃描本地音樂文件。
   • 使用mutagen讀取元數據（流派、標題、藝術家等）。
   • 過濾匹配心情的歌曲。
   • 創建.m3u播放列表。
   • 將其保存到用戶機器上的指定位置。

技術棧

• Python：項目的主要編程語言。
• uv ：異步Web服務器，用於處理請求。
• mutagen ：用於元數據提取，幫助篩選歌曲。

🙏 特別鳴謝

衷心感謝文件系統MCP服務器，此項目基於您的創意構建。

💬 反饋？

打開問題或聯繫我。接受PR，更接受基於心情的音樂推薦！🎶

需求詢問

• 如果用戶未選擇位置，默認目錄是什麼？
• 您是否僅支持MP3格式，還是也支持其他格式？
• 是否應包含開發人員的API路由結構？

請告知，我會進行更新。