内容
# 🎧 MCP 播放列表生成器
这个项目是一个 **Model Context Provider (MCP) server**，旨在与 Claude 或任何支持工具使用的 AI 助手配合工作。它根据用户当前的心情或主题在用户的 PC 上生成 `.m3u` 播放列表。播放列表会保存到用户指定的目录，随时可以在您最喜欢的媒体播放器中排队播放。
> 使用 Python 构建，基于 `uv` 和 `mutagen`，灵感来源于传奇的 **Filesystem MCP Server** — 特别感谢这个创意和基础参考！
---
## 🛠 工作原理
1. **用户使用 Python 和 `uv` 设置 MCP 服务器**。
2. 服务器监听来自 Claude 或任何 LLM 代理的请求。
3. 根据请求（例如，“制作一个轻松的晚间播放列表”），它：
- 扫描本地音乐文件。
- 使用 `mutagen` 读取元数据（流派、标题、艺术家等）。
- 筛选符合氛围的歌曲。
- 创建一个 `.m3u` 播放列表。
- 将其保存在用户机器上的指定位置。
---
## 🔧 技术栈
- **Python**
- [`uv`](https://pypi.org/project/uv/) — 用于异步网络服务器
- [`mutagen`](https://mutagen.readthedocs.io/) — 用于元数据提取
---
## 📦 安装
```bash
pip install uv mutagen
```
克隆此仓库并运行：
```bash
uvicorn mcp_server:app --reload
```
## 🧠 示例 Claude 提示
> “嘿 Claude，你能为我制作一个快乐氛围的播放列表吗？”
然后 Claude 将使用 MCP 服务器工具，哗啦 — 您将在音乐应用中获得一个播放列表。
> [!important]
> 创建播放列表后，请确保您 `re-index` 音乐应用。
## 🙏 特别感谢
非常感谢 `Filesystem MCP Server` — 这个项目是以您的创意为灵感构建的。
## 💬 有反馈吗？
请打开一个问题或联系我。欢迎提交 PR，基于心情的音乐更受欢迎 🎶
---
### 需要：
- 如果用户没有选择位置，默认目录回退是什么？
- 您只支持 MP3 格式，还是其他格式也支持？
- 我应该为开发者包含 API 路由结构吗？
告诉我，我会进行更新。
MCP 市场