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路由结构？

请告知，我会进行更新。