Metadata-Version: 2.4
Name: ben-music-mcp
Version: 0.1.16
Summary: 本的乐mcp服务
Author: ben
Author-email: 2014911413@qq.com
Requires-Python: >=3.12
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: fastmcp (>=2.13.0.2)
Requires-Dist: psutil (>=6.1.1)
Requires-Dist: pyautogui (>=0.9.54)
Requires-Dist: requests (>=2.32.4)
Requires-Dist: uiautomation (>=2.0.20)
Description-Content-Type: text/markdown

# ben-music-mcp

本产品是一套面向开发者和智能体的音乐信息服务工具，专注于高效、专业的音乐数据获取与个性化推荐。所有接口均采用标准 JSON 格式，便于自动化集成与二次开发。

---

## 产品功能概览

### 歌曲与歌手信息
- **歌曲检索**：支持通过关键词精准获取歌曲详情，包括名称、艺人、专辑等核心信息。
- **歌词查询**：一键获取任意歌曲的完整歌词文本。
- **歌手检索与详情**：快速定位歌手并获取其详细资料及代表作品。
- **热门歌曲榜单**：自动获取歌手最受欢迎的曲目列表。

### 音乐播放与评论
- **在线试听链接**：根据需求获取不同音质等级的音乐播放地址。
- **热门评论提取**：智能筛选并返回歌曲的高质量评论，便于用户快速了解口碑。
- **相似歌曲推荐**：基于音乐特征，智能推荐与目标歌曲风格相近的作品。

### 歌单与榜单服务
- **歌单详情查询**：支持按歌单编号获取完整歌单信息，涵盖曲目、封面、创建者等。
- **排行榜检索**：覆盖主流及特色音乐榜单，助力发现最新流行趋势。
- **用户歌单获取**：根据用户昵称，自动获取其公开歌单列表。

### 曲风与标签体系
- **曲风分类查询**：支持按风格名称获取对应曲风下的热门歌曲。
- **风格列表获取**：一键获取所有可选音乐风格，便于个性化筛选。
- **榜单名称获取**：快速获取所有可用排行榜名称，提升榜单检索效率。

### 用户与客户端服务
- **用户身份查询**：通过昵称获取用户唯一标识，便于个性化服务。
- **本地客户端启动**：支持远程启动本地网易云音乐客户端，提升桌面体验。

---


## 接口返回格式
所有接口均返回标准结构，便于前后端集成：

```json
{
	"code": 200,        // 状态码，200 表示成功
	"msg": "success",   // 状态信息
	"data": {...}       // 具体数据内容
}
```

---

## 技术与环境要求
- Python 3.8 及以上
- requests
- fastmcp

