🎧 MCP Playlist Generator

基本能力

产品定位

playlist-mcp-server 是一个用于生成和管理音乐播放列表的工具，特别适合与 AI 助手集成，根据用户的心情或主题自动创建播放列表。

核心功能

1. 播放列表生成：根据用户的心情或主题（如“轻松的晚间播放列表”）生成 .m3u 播放列表。
2. 本地音乐文件扫描：扫描用户本地的音乐文件。
3. 元数据读取：使用 mutagen 读取音乐文件的元数据（如流派、标题、艺术家等）。
4. 歌曲过滤：根据用户的需求过滤匹配的歌曲。
5. 播放列表保存：将生成的播放列表保存到用户指定的目录。

适用场景

1. 个人娱乐：用户可以通过 AI 助手快速生成符合当前心情的播放列表。
2. 音乐管理：帮助用户整理和分类本地音乐文件。
3. AI 集成：为 AI 助手提供音乐播放列表生成的能力。

工具列表

1. uv：用于异步 Web 服务器。
2. mutagen：用于音乐文件的元数据提取。

常见问题解答

1. 默认目录：如果用户未指定目录，播放列表将保存到哪个默认目录？
2. 支持格式：是否仅支持 MP3，还是也支持其他格式？
3. API 路由结构：是否需要为开发者提供 API 路由结构？

使用教程

使用依赖

安装以下依赖：

pip install uv mutagen

安装教程

1. 克隆项目仓库。
2. 运行以下命令启动服务器：

uvicorn mcp_server:app --reload

调试方式

1. 启动服务器后，可以通过 AI 助手发送请求测试播放列表生成功能。
2. 确保音乐应用程序在创建播放列表后重新索引。

许可证

该项目遵循 GPL-3.0 开源许可条款，请参阅 GPL-3.0 了解完整条款。