🎧 MCP Playlist Generator

🎧 MCP 播放列表生成器

此项目是一个 模型上下文提供者（MCP）服务，旨在与 Claude 或任何支持工具调用的 AI 助手配合使用。它会根据用户当前的心情或主题，在用户的电脑上生成 .m3u 播放列表。播放列表会保存到用户指定的目录中，随时可以在你最喜欢的媒体播放器中排队播放。

使用 Python 构建，由 uv 和 mutagen 提供支持，灵感来自传奇的 Filesystem MCP Server——特别感谢它带来的创意和基础参考！

---

🛠 工作原理

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

---

🔧 技术栈

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

---

📦 安装

pip install uv mutagen

克隆此仓库并运行：

uvicorn mcp_server:app --reload

🧠 Claude 提示词示例

“嘿 Claude，能帮我制作一份欢快氛围的播放列表吗？”

随后 Claude 会调用 MCP 服务工具，转眼间你就能在音乐应用中获得一份播放列表。

重要

创建播放列表后，请务必在音乐应用中重新索引。

🙏 特别鸣谢

非常感谢 Filesystem MCP Server——本项目以你的创意为灵感而构建。

💬 有什么反馈？

欢迎提交 issue 或联系我。欢迎提交 PR，也欢迎分享更多基于心情的音乐灵感 🎶

---

需要确认：

• 用户未选择位置时，默认回退目录是什么？
• 目前仅支持 MP3，还是也支持其他格式？
• 是否应该为开发者补充 API 路由结构？

告诉我，我会更新。