playlist-mcp-server

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

本项目是一个专为Claude或其他支持工具使用的AI助手打造的情境模型提供者（MCP）服务器。它能够依据用户当前的心情或主题，在本地计算机上生成.m3u播放列表，并将其保存到用户指定的目录，方便随时在喜爱的媒体播放器中播放。

🚀 快速开始

本项目使用Python构建，由uv和mutagen驱动，其灵感源自传奇的文件系统MCP服务器，在此特别感谢其创意和基础参考！

✨ 主要特性

• 依据用户当前心情或主题，在本地计算机生成.m3u播放列表。
• 播放列表可保存至用户指定目录，便于在媒体播放器中播放。

🛠 工作原理

1. 用户设置MCP服务器：使用Python和uv进行服务器设置。
2. 监听请求：服务器监听来自Claude或其他LLM代理的请求。
3. 生成播放列表：根据请求（例如“创建一个轻松的晚上播放列表”），执行以下操作：
   • 扫描本地音乐文件。
   • 使用mutagen读取元数据（流派、标题、艺术家等）。
   • 过滤匹配心情的歌曲。
   • 创建.m3u播放列表。
   • 将其保存到用户机器上的指定位置。

🔧 技术细节

本项目的技术栈主要包含以下部分：

• Python：作为主要的开发语言。
• uv ：异步Web服务器，用于处理请求。
• mutagen ：用于元数据提取，帮助筛选匹配心情的歌曲。

📦 安装指南

安装依赖

pip install uv mutagen

克隆仓库并运行

uvicorn mcp_server:app --reload

💻 使用示例

基础用法

在Claude中输入提示，例如：

“嘿Claude，你能为我创建一个快乐心情的播放列表吗？”

Claude会使用MCP服务器工具生成播放列表，您会在音乐应用程序中获得该播放列表。

⚠️ 重要提示

创建播放列表后请确保重新索引您的Music应用程序。

🙏 特别鸣谢

衷心感谢文件系统MCP服务器，此项目基于您的创意构建。

💬 反馈

如果您有任何反馈，可以打开问题或联系我。我们接受PR，更期待基于心情的音乐推荐！🎶

需求询问

• 如果用户未选择位置，默认目录是什么？
• 您是否仅支持MP3格式，还是也支持其他格式？
• 是否应包含开发人员的API路由结构？

请告知，我会进行更新。