🎧 MCP 播放列表生成器

该项目是一个模型上下文提供者（MCP）服务器，旨在与Claude或其他支持工具使用的AI助手配合工作。它基于用户当前的心情或主题，在用户的PC上生成.m3u播放列表。播放列表保存到用户指定的目录中，准备在您最喜欢的媒体播放器中播放。

使用Python构建，由uv和mutagen驱动，并受到传奇的文件系统MCP服务器启发——对这个想法和基础参考给予重大致敬！

---

🛠 工作原理

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

---

🔧 技术栈

• Python
• uv — 用于异步Web服务器
• mutagen — 用于元数据提取

---

📦 安装

pip install uv mutagen

克隆此仓库并运行：

uvicorn mcp_server:app --reload

🧠 示例Claude提示

“嘿Claude，你能给我做一个快乐心情的播放列表吗。”

然后Claude将使用MCP服务器工具，瞬间——您会在音乐应用中得到一个播放列表。

[!important] 创建播放列表后，请确保您重新索引了音乐应用。

🙏 特别感谢

特别感谢文件系统MCP服务器——这个项目是在您的想法启发下建立的。

💬 有反馈？

打开一个问题或联系我。欢迎PR，基于心情的混音更是如此 🎶

---

需求：

• 如果用户没有选择位置，默认目录是什么？
• 是否仅支持MP3，还是也支持其他格式？
• 我是否应该包括API路由结构供开发者使用？

告诉我，我会更新它。