ben-music-mcp 0.1.1__tar.gz → 0.1.4__tar.gz

ben_music_mcp-0.1.4/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: ben-music-mcp
+Version: 0.1.4
+Summary: 
+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: requests (>=2.32.4)
+Description-Content-Type: text/markdown
+
+# ben-music-mcp
+
+本产品是一套面向开发者和智能体的音乐信息服务工具，专注于高效、专业的音乐数据获取与个性化推荐。所有接口均采用标准 JSON 格式，便于自动化集成与二次开发。
+
+---
+
+## 产品功能概览
+
+### 歌曲与歌手信息
+- **歌曲检索**：支持通过关键词精准获取歌曲详情，包括名称、艺人、专辑等核心信息。
+- **歌词查询**：一键获取任意歌曲的完整歌词文本。
+- **歌手检索与详情**：快速定位歌手并获取其详细资料及代表作品。
+- **热门歌曲榜单**：自动获取歌手最受欢迎的曲目列表。
+
+### 音乐播放与评论
+- **在线试听链接**：根据需求获取不同音质等级的音乐播放地址。
+- **热门评论提取**：智能筛选并返回歌曲的高质量评论，便于用户快速了解口碑。
+- **相似歌曲推荐**：基于音乐特征，智能推荐与目标歌曲风格相近的作品。
+
+### 歌单与榜单服务
+- **歌单详情查询**：支持按歌单编号获取完整歌单信息，涵盖曲目、封面、创建者等。
+- **排行榜检索**：覆盖主流及特色音乐榜单，助力发现最新流行趋势。
+- **用户歌单获取**：根据用户昵称，自动获取其公开歌单列表。
+
+### 曲风与标签体系
+- **曲风分类查询**：支持按风格名称获取对应曲风下的热门歌曲。
+- **风格列表获取**：一键获取所有可选音乐风格，便于个性化筛选。
+- **榜单名称获取**：快速获取所有可用排行榜名称，提升榜单检索效率。
+
+### 用户与客户端服务
+- **用户身份查询**：通过昵称获取用户唯一标识，便于个性化服务。
+- **本地客户端启动**：支持远程启动本地网易云音乐客户端，提升桌面体验。
+
+---
+
+
+## 接口返回格式
+所有接口均返回标准结构，便于前后端集成：
+
+```json
+{
+	"code": 200,        // 状态码，200 表示成功
+	"msg": "success",   // 状态信息
+	"data": {...}       // 具体数据内容
+}
+```
+
+---
+
+## 技术与环境要求
+- Python 3.8 及以上
+- requests
+- fastmcp
+

ben_music_mcp-0.1.4/README.md

@@ -0,0 +1,53 @@
+# ben-music-mcp
+
+本产品是一套面向开发者和智能体的音乐信息服务工具，专注于高效、专业的音乐数据获取与个性化推荐。所有接口均采用标准 JSON 格式，便于自动化集成与二次开发。
+
+---
+
+## 产品功能概览
+
+### 歌曲与歌手信息
+- **歌曲检索**：支持通过关键词精准获取歌曲详情，包括名称、艺人、专辑等核心信息。
+- **歌词查询**：一键获取任意歌曲的完整歌词文本。
+- **歌手检索与详情**：快速定位歌手并获取其详细资料及代表作品。
+- **热门歌曲榜单**：自动获取歌手最受欢迎的曲目列表。
+
+### 音乐播放与评论
+- **在线试听链接**：根据需求获取不同音质等级的音乐播放地址。
+- **热门评论提取**：智能筛选并返回歌曲的高质量评论，便于用户快速了解口碑。
+- **相似歌曲推荐**：基于音乐特征，智能推荐与目标歌曲风格相近的作品。
+
+### 歌单与榜单服务
+- **歌单详情查询**：支持按歌单编号获取完整歌单信息，涵盖曲目、封面、创建者等。
+- **排行榜检索**：覆盖主流及特色音乐榜单，助力发现最新流行趋势。
+- **用户歌单获取**：根据用户昵称，自动获取其公开歌单列表。
+
+### 曲风与标签体系
+- **曲风分类查询**：支持按风格名称获取对应曲风下的热门歌曲。
+- **风格列表获取**：一键获取所有可选音乐风格，便于个性化筛选。
+- **榜单名称获取**：快速获取所有可用排行榜名称，提升榜单检索效率。
+
+### 用户与客户端服务
+- **用户身份查询**：通过昵称获取用户唯一标识，便于个性化服务。
+- **本地客户端启动**：支持远程启动本地网易云音乐客户端，提升桌面体验。
+
+---
+
+
+## 接口返回格式
+所有接口均返回标准结构，便于前后端集成：
+
+```json
+{
+	"code": 200,        // 状态码，200 表示成功
+	"msg": "success",   // 状态信息
+	"data": {...}       // 具体数据内容
+}
+```
+
+---
+
+## 技术与环境要求
+- Python 3.8 及以上
+- requests
+- fastmcp

{ben_music_mcp-0.1.1 → ben_music_mcp-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ben-music-mcp"
-version = "0.1.1"
+version = "0.1.4"
 description = ""
 authors = [
     {name = "ben",email = "2014911413@qq.com"}

{ben_music_mcp-0.1.1 → ben_music_mcp-0.1.4}/src/ben_music_mcp/__init__.py

@@ -1,5 +1,7 @@
 
 
+
+
 from fastmcp import FastMCP
 from .tool import (
     _hello,
@@ -20,6 +22,8 @@ from .tool import (
     _start_netease_music,
     _get_uid,
     _get_user_playlist,
+    _return_stylelist,
+    _return_toplist_name,
     global_cookie
 )
 
@@ -28,10 +32,13 @@ mcp = FastMCP("MCPService")
 
 @mcp.tool
 def hello() -> dict:
-    """方法注释"""
+    """测试使用,version=0.1.4"""
     return _hello()
 
 
+
+
+
 @mcp.tool
 def get_song_info(keywords: str) -> dict:
     """
@@ -41,76 +48,95 @@ def get_song_info(keywords: str) -> dict:
     """
     return _get_song_info(keywords)
 
+# @mcp.tool
+# def get_song_id(keywords: str) -> dict:
+#     """
+#     根据关键词搜索歌曲，返回第一首歌的ID
+#     :param keywords: 歌曲关键词
+#     :return: 歌曲ID
+#     """
+#     return _get_song_id(keywords)
 
 @mcp.tool
-def get_song_id(keywords: str) -> dict:
+def lyric(keywords: str) -> dict:
     """
-    根据关键词搜索歌曲，返回第一首歌的ID
+    根据歌名关键词搜索歌词
     :param keywords: 歌曲关键词
-    :return: 歌曲ID
+    :return: 歌词文本
     """
-    return _get_song_id(keywords)
+    return _lyric(keywords)
 
+@mcp.tool
+def get_music_url(keywords: str, level: str = "standard") -> dict:
+    """
+    根据关键词获取音乐在线试听url
+    :param keywords: 歌曲关键词
+    :param level: 音质等级
+    :return: 音乐url json
+    """
+    return _get_music_url(keywords, level)
 
 @mcp.tool
-def lyric(keywords: str) -> dict:
+def get_song_comment(keywords: str) -> dict:
     """
-    根据歌名关键词搜索歌词（内部先获取歌曲ID）
+    根据歌名关键词获取歌曲评论
     :param keywords: 歌曲关键词
-    :return: 歌词文本
+    :return: 歌曲评论json
     """
-    return _lyric(keywords)
+    return _get_song_comment(keywords)
+
+@mcp.tool
+def get_similar_songs(keywords: str) -> dict:
+    """
+    根据关键词获取相似音乐（先查id再查/simi/song）
+    :param keywords: 歌曲关键词
+    :return: 相似音乐json
+    """
+    return _get_similar_songs(keywords)
+
+@mcp.tool
+def get_style_songs(style_name: str) -> dict:
+    """
+    根据曲风名返回歌曲列表。
+    :param style_name: 曲风名
+    :return: 歌曲列表json
+    """
+    return _get_style_songs(style_name)
+
+
+
 
 
 @mcp.tool
 def search_artist(keyword: str) -> dict:
     """
-    根据关键词搜索歌手信息，自动带上cookie
+    根据关键词搜索歌手信息
     :param keyword: 歌手关键词
     :return: 歌手信息字符串
     """
     return _search_artist(keyword)
 
-
 @mcp.tool
 def get_artist_info(keyword: str) -> dict:
     """
-    根据关键词获取歌手详细信息，先查id再查详情，返回json
+    根据关键词获取歌手详细信息
     :param keyword: 歌手关键词
     :return: 歌手详细信息json
     """
     return _get_artist_info(keyword)
 
-
 @mcp.tool
 def get_artist_hot_songs(keyword: str) -> dict:
     """
-    根据关键词获取歌手最火的50首歌曲，先查id再查热门歌曲，返回json
+    根据关键词获取歌手最火的50首歌曲
     :param keyword: 歌手关键词
     :return: 热门歌曲json
     """
     return _get_artist_hot_songs(keyword)
 
 
-@mcp.tool
-def get_music_url(keywords: str, level: str = "standard") -> dict:
-    """
-    根据关键词获取音乐播放url，先查歌曲id再查url，返回json
-    :param keywords: 歌曲关键词
-    :param level: 音质等级
-    :return: 音乐url json
-    """
-    return _get_music_url(keywords, level)
 
 
-@mcp.tool
-def get_song_comment(keywords: str) -> dict:
-    """
-    根据关键词获取歌曲评论，先查歌曲id再查评论，返回json
-    :param keywords: 歌曲关键词
-    :return: 歌曲评论json
-    """
-    return _get_song_comment(keywords)
 
 @mcp.tool
 def get_playlist(id: int) -> dict:
@@ -124,44 +150,29 @@ def get_playlist(id: int) -> dict:
 @mcp.tool
 def get_toplist(name: str) -> dict:
     """
-    根据排行榜名获取榜单详情（先查id再查_get_playlist）
+    根据排行榜名字获取榜单详情（先查id再查_get_playlist）
     :param name: 榜单名称
     :return: 榜单详情json
     """
     return _get_toplist(name)
 
-@mcp.tool
-def get_similar_songs(keywords: str) -> dict:
-    """
-    根据关键词获取相似音乐（先查id再查/simi/song）
-    :param keywords: 歌曲关键词
-    :return: 相似音乐json
-    """
-    return _get_similar_songs(keywords)
 
-@mcp.tool
-def get_style_songs(style_name: str) -> dict:
-    """
-    根据曲风名返回歌曲列表。
-    :param style_name: 曲风名
-    :return: 歌曲列表json
-    """
-    return _get_style_songs(style_name)
 
 
-@mcp.tool()
-def get_uid(nickname: str) -> dict:
-    """
-    根据用户昵称获取其uid
-    :param nickname: 用户昵称
-    :return: 用户uid json
-    """
-    return _get_uid(nickname)
+
+# @mcp.tool()
+# def get_uid(nickname: str) -> dict:
+#     """
+#     根据用户昵称获取其uid
+#     :param nickname: 用户昵称
+#     :return: 用户uid json
+#     """
+#     return _get_uid(nickname)
 
 @mcp.tool()
 def get_user_playlist(nickname: str) -> dict:
     """
-    输入用户昵称，获取用户歌单（只保留必要字段）
+    输入用户昵称，获取用户歌单（含有歌单id）
     :param nickname: 用户昵称
     :return: 歌单列表json
     """
@@ -172,20 +183,38 @@ def get_user_playlist(nickname: str) -> dict:
 
 
 @mcp.tool
-def login_anonymous() -> dict:
+def return_stylelist() -> dict:
     """
-    游客登录，获取游客 cookie，并保存到全局变量
-    :return: 游客 cookie 字符串
+    返回所有风格名称（不含id），从styleList.json读取。没有输入参数
+    :return: {"code": 200, "msg": "success", "data": [风格名列表]}
     """
-    return _login_anonymous()
+    return _return_stylelist()
 
 @mcp.tool
-def login_refresh() -> dict:
+def return_toplist_name() -> dict:
     """
-    刷新登录状态，获取新的 cookie
-    :return: 新的 cookie 字符串
+    返回所有排行榜名称（不含id），从toplist.json读取。没有输入参数
+    :return: {"code": 200, "msg": "success", "data": [榜单名列表]}
     """
-    return _login_refresh()
+    return _return_toplist_name()
+
+
+
+# @mcp.tool
+# def login_anonymous() -> dict:
+#     """
+#     游客登录，获取游客 cookie，并保存到全局变量
+#     :return: 游客 cookie 字符串
+#     """
+#     return _login_anonymous()
+
+# @mcp.tool
+# def login_refresh() -> dict:
+#     """
+#     刷新登录状态，获取新的 cookie
+#     :return: 新的 cookie 字符串
+#     """
+#     return _login_refresh()
 
 
 @mcp.tool()

{ben_music_mcp-0.1.1 → ben_music_mcp-0.1.4}/src/ben_music_mcp/tool.py

@@ -1,5 +1,4 @@
 
-
 import subprocess
 import requests
 
@@ -287,7 +286,8 @@ def _get_toplist(name: str) -> dict:
     :return: 榜单详情json
     """
     try:
-        with open("toplist.json", "r", encoding="utf-8") as f:
+        path = os.path.join(os.path.dirname(__file__), "toplist.json")
+        with open(path, "r", encoding="utf-8") as f:
             data = json.load(f)
         toplists = data.get("toplists", [])
         match = next((item for item in toplists if item.get("name") == name), None)
@@ -337,7 +337,8 @@ def _get_style_songs(style_name: str) -> dict:
 
     # 读取 styleList.json
     try:
-        with open("styleList.json", "r", encoding="utf-8") as f:
+        path = os.path.join(os.path.dirname(__file__), "styleList.json")
+        with open(path, "r", encoding="utf-8") as f:
             style_list = json.load(f)
     except Exception as e:
         return {"code": 500, "msg": f"读取曲风列表失败: {e}", "data": {}}
@@ -450,6 +451,36 @@ def _get_user_playlist(nickname: str) -> dict:
         return {"code": 500, "msg": f"请求失败: {e}", "data": []}
 
 
+def _return_stylelist() -> dict:
+    """
+    返回所有风格名称（不含id），从styleList.json读取。
+    :return: {"code": 200, "msg": "success", "data": [风格名列表]}
+    """
+    try:
+        path = os.path.join(os.path.dirname(__file__), "styleList.json")
+        with open(path, "r", encoding="utf-8") as f:
+            style_list = json.load(f)
+        names = [item.get("tagName", "") for item in style_list if item.get("tagName")]
+        return {"code": 200, "msg": "success", "data": names}
+    except Exception as e:
+        return {"code": 500, "msg": f"读取风格列表失败: {e}", "data": []}
+
+
+def _return_toplist_name() -> dict:
+    """
+    返回所有排行榜名称（不含id），从toplist.json读取。
+    :return: {"code": 200, "msg": "success", "data": [榜单名列表]}
+    """
+    try:
+        path = os.path.join(os.path.dirname(__file__), "toplist.json")
+        with open(path, "r", encoding="utf-8") as f:
+            data = json.load(f)
+        toplists = data.get("toplists", [])
+        names = [item.get("name", "") for item in toplists if item.get("name")]
+        return {"code": 200, "msg": "success", "data": names}
+    except Exception as e:
+        return {"code": 500, "msg": f"读取榜单列表失败: {e}", "data": []}
+
 
 
 def _login_anonymous() -> dict:

ben_music_mcp-0.1.1/PKG-INFO

@@ -1,99 +0,0 @@
-Metadata-Version: 2.4
-Name: ben-music-mcp
-Version: 0.1.1
-Summary: 
-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: requests (>=2.32.4)
-Description-Content-Type: text/markdown
-
-# API 工具说明
-
-本项目基于 FastMCP，封装了音乐相关常用接口，所有方法均以 JSON 格式返回，适合自动化调用和二次开发。
-
-## 方法列表
-
-### 1. hello
-测试方法，返回示例字符串。
-
-### 2. get_song_info(keywords)
-根据关键词搜索歌曲信息，返回首条歌曲的详细信息（id、name、artists、album、alias、transNames、duration、fee、mvid）。
-
-### 3. get_song_id(keywords)
-根据关键词搜索歌曲，返回第一首歌的ID。
-
-### 4. lyric(keywords)
-根据歌名关键词搜索歌词（内部先获取歌曲ID），返回歌词文本。
-
-### 5. search_artist(keyword)
-根据关键词搜索歌手信息，自动带上 cookie，返回首个歌手的基本信息（artistName、artistId、avatar）。
-
-### 6. get_artist_info(keyword)
-根据关键词获取歌手详细信息，先查 id 再查详情，返回完整歌手信息。
-
-### 7. get_artist_hot_songs(keyword)
-根据关键词获取歌手最火的 50 首歌曲，先查 id 再查热门歌曲。
-
-### 8. get_music_url(keywords, level="standard")
-根据关键词获取音乐播放 url，先查歌曲 id 再查 url，支持音质等级选择。
-
-### 9. get_song_comment(keywords)
-根据关键词获取歌曲评论，先查歌曲 id 再查评论，只保留有用字段（nickname、content、likedCount、timeStr）。
-
-### 10. get_playlist(id)
-根据歌单 id 获取歌单详情，只返回关键字段（id、name、coverImgUrl、userId、trackCount、playCount、tracks 等）。
-
-### 11. get_toplist(name)
-根据排行榜名获取榜单详情（先查 id 再查 get_playlist）。
-
-### 12. get_similar_songs(keywords)
-根据关键词获取相似音乐（先查 id 再查 /simi/song），只保留关键信息。
-
-### 13. get_style_songs(style_name)
-根据曲风名返回歌曲列表（先查曲风 id，再查 /style/song），只保留关键信息（id、name、artists、album、duration）。
-
-### 14. get_uid(nickname)
-根据用户昵称获取其 uid，返回 uid 和昵称。
-
-### 15. get_user_playlist(nickname)
-输入用户昵称，获取用户歌单（先查 uid，再查 /user/playlist），只保留必要字段（id、name、coverImgUrl、trackCount、playCount、creator 信息）。
-
-### 16. login_anonymous()
-游客登录，获取游客 cookie，并保存到全局变量。
-
-### 17. login_refresh()
-刷新登录状态，获取新的 cookie。
-
-### 18. start_netease_music(exe_path="C:\\CloudMusic\\cloudmusic.exe")
-启动本地网易云音乐客户端，支持自定义 exe 路径。
-
-## 返回格式
-所有方法均返回如下结构：
-
-```json
-{
-	"code": 200,           // 状态码，200 表示成功
-	"msg": "success",      // 状态信息
-	"data": {...}          // 具体数据内容
-}
-```
-
-## 使用说明
-1. 推荐通过 MCP 工具接口调用各方法。
-2. 部分方法（如评论、歌单、曲风）已做字段精简，适合前端展示和二次处理。
-3. 启动本地网易云客户端需 Windows 环境，默认路径可自定义。
-
-## 依赖
-- Python 3.8+
-- requests
-- fastmcp
-
-## 维护
-如需扩展新接口或字段，请参考 tool.py 和 server.py 的实现风格。
-

ben_music_mcp-0.1.1/README.md

@@ -1,83 +0,0 @@
-# API 工具说明
-
-本项目基于 FastMCP，封装了音乐相关常用接口，所有方法均以 JSON 格式返回，适合自动化调用和二次开发。
-
-## 方法列表
-
-### 1. hello
-测试方法，返回示例字符串。
-
-### 2. get_song_info(keywords)
-根据关键词搜索歌曲信息，返回首条歌曲的详细信息（id、name、artists、album、alias、transNames、duration、fee、mvid）。
-
-### 3. get_song_id(keywords)
-根据关键词搜索歌曲，返回第一首歌的ID。
-
-### 4. lyric(keywords)
-根据歌名关键词搜索歌词（内部先获取歌曲ID），返回歌词文本。
-
-### 5. search_artist(keyword)
-根据关键词搜索歌手信息，自动带上 cookie，返回首个歌手的基本信息（artistName、artistId、avatar）。
-
-### 6. get_artist_info(keyword)
-根据关键词获取歌手详细信息，先查 id 再查详情，返回完整歌手信息。
-
-### 7. get_artist_hot_songs(keyword)
-根据关键词获取歌手最火的 50 首歌曲，先查 id 再查热门歌曲。
-
-### 8. get_music_url(keywords, level="standard")
-根据关键词获取音乐播放 url，先查歌曲 id 再查 url，支持音质等级选择。
-
-### 9. get_song_comment(keywords)
-根据关键词获取歌曲评论，先查歌曲 id 再查评论，只保留有用字段（nickname、content、likedCount、timeStr）。
-
-### 10. get_playlist(id)
-根据歌单 id 获取歌单详情，只返回关键字段（id、name、coverImgUrl、userId、trackCount、playCount、tracks 等）。
-
-### 11. get_toplist(name)
-根据排行榜名获取榜单详情（先查 id 再查 get_playlist）。
-
-### 12. get_similar_songs(keywords)
-根据关键词获取相似音乐（先查 id 再查 /simi/song），只保留关键信息。
-
-### 13. get_style_songs(style_name)
-根据曲风名返回歌曲列表（先查曲风 id，再查 /style/song），只保留关键信息（id、name、artists、album、duration）。
-
-### 14. get_uid(nickname)
-根据用户昵称获取其 uid，返回 uid 和昵称。
-
-### 15. get_user_playlist(nickname)
-输入用户昵称，获取用户歌单（先查 uid，再查 /user/playlist），只保留必要字段（id、name、coverImgUrl、trackCount、playCount、creator 信息）。
-
-### 16. login_anonymous()
-游客登录，获取游客 cookie，并保存到全局变量。
-
-### 17. login_refresh()
-刷新登录状态，获取新的 cookie。
-
-### 18. start_netease_music(exe_path="C:\\CloudMusic\\cloudmusic.exe")
-启动本地网易云音乐客户端，支持自定义 exe 路径。
-
-## 返回格式
-所有方法均返回如下结构：
-
-```json
-{
-	"code": 200,           // 状态码，200 表示成功
-	"msg": "success",      // 状态信息
-	"data": {...}          // 具体数据内容
-}
-```
-
-## 使用说明
-1. 推荐通过 MCP 工具接口调用各方法。
-2. 部分方法（如评论、歌单、曲风）已做字段精简，适合前端展示和二次处理。
-3. 启动本地网易云客户端需 Windows 环境，默认路径可自定义。
-
-## 依赖
-- Python 3.8+
-- requests
-- fastmcp
-
-## 维护
-如需扩展新接口或字段，请参考 tool.py 和 server.py 的实现风格。