ben-music-mcp 0.1.9__tar.gz

ben_music_mcp-0.1.9/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: ben-music-mcp
+Version: 0.1.9
+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: 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
+

ben_music_mcp-0.1.9/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.9/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "ben-music-mcp"
+version = "0.1.9"
+description = "考虑了平台兼容性"
+authors = [
+    {name = "ben",email = "2014911413@qq.com"}
+]
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "requests>=2.32.4",
+    "fastmcp>=2.13.0.2",
+    "pyautogui>=0.9.54",
+    "psutil>=6.1.1",
+    "uiautomation>=2.0.20"
+]
+
+[tool.poetry]
+packages = [{include = "ben_music_mcp", from = "src"}]
+
+[project.scripts]
+ben-music-mcp = "ben_music_mcp:main"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

ben_music_mcp-0.1.9/src/ben_music_mcp/__init__.py

@@ -0,0 +1,280 @@
+from fastmcp import FastMCP
+from .action import (
+    _open_cloud_music,
+    _search_and_play,
+    _play_and_pause,
+    _next_song,
+    _pre_song,
+    exe_path0
+)
+from .tool import (
+    _hello,
+    _get_song_info,
+    _get_song_id,
+    _lyric,
+    _search_artist,
+    _login_anonymous,
+    _login_refresh,
+    _get_artist_info,
+    _get_artist_hot_songs,
+    _get_music_url,
+    _get_song_comment,
+    _get_playlist,
+    _get_toplist,
+    _get_similar_songs,
+    _get_style_songs,
+    _start_netease_music,
+    _get_uid,
+    _get_user_playlist,
+    _return_stylelist,
+    _return_toplist_name,
+    global_cookie
+)
+
+mcp = FastMCP("MCPService")
+
+
+@mcp.tool
+def hello() -> dict:
+    """version=0.1.9"""
+    return _hello()
+
+
+
+
+
+@mcp.tool
+def get_song_info(keywords: str) -> dict:
+    """
+    根据关键词搜索歌曲信息，歌曲id无需向用户透漏
+    :param keywords: 歌曲关键词
+    :return: 歌曲信息
+    """
+    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 lyric(keywords: str) -> dict:
+    """
+    根据歌名关键词搜索歌词
+    :param keywords: 歌曲关键词
+    :return: 歌词文本
+    """
+    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 get_song_comment(keywords: str) -> dict:
+    """
+    根据歌名关键词获取歌曲评论
+    :param keywords: 歌曲关键词
+    :return: 歌曲评论json
+    """
+    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:
+    """
+    根据关键词搜索歌手信息
+    :param keyword: 歌手关键词
+    :return: 歌手信息字符串
+    """
+    return _search_artist(keyword)
+
+@mcp.tool
+def get_artist_info(keyword: str) -> dict:
+    """
+    根据关键词获取歌手详细信息
+    :param keyword: 歌手关键词
+    :return: 歌手详细信息json
+    """
+    return _get_artist_info(keyword)
+
+@mcp.tool
+def get_artist_hot_songs(keyword: str) -> dict:
+    """
+    根据关键词获取歌手最火的50首歌曲
+    :param keyword: 歌手关键词
+    :return: 热门歌曲json
+    """
+    return _get_artist_hot_songs(keyword)
+
+
+
+
+
+@mcp.tool
+def get_playlist(id: int) -> dict:
+    """
+    根据歌单id获取歌单详情
+    :param id: 歌单id
+    :return: 歌单详情json
+    """
+    return _get_playlist(id)
+
+@mcp.tool
+def get_toplist(name: str) -> dict:
+    """
+    根据排行榜名字获取榜单详情（先查id再查_get_playlist）
+    :param name: 榜单名称
+    :return: 榜单详情json
+    """
+    return _get_toplist(name)
+
+
+
+
+
+# @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
+    """
+    return _get_user_playlist(nickname)
+
+
+
+
+
+@mcp.tool
+def return_stylelist() -> dict:
+    """
+    返回所有风格名称（不含id），从styleList.json读取。没有输入参数
+    :return: {"code": 200, "msg": "success", "data": [风格名列表]}
+    """
+    return _return_stylelist()
+
+@mcp.tool
+def return_toplist_name() -> dict:
+    """
+    返回所有排行榜名称（不含id），从toplist.json读取。没有输入参数
+    :return: {"code": 200, "msg": "success", "data": [榜单名列表]}
+    """
+    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()
+# def start_netease_music(exe_path: str) -> dict:
+#     """
+#     启动本地网易云音乐客户端
+#     :param exe_path: 网易云音乐客户端的 exe 路径，默认 C:\\CloudMusic\\cloudmusic.exe
+#     :return: 启动结果 json
+#     """
+#     return _start_netease_music(exe_path)
+
+@mcp.tool()
+def open_cloud_music(exe_path: str = None) -> dict:
+    """
+    启动本地网易云音乐客户端
+    :param exe_path: 网易云音乐客户端的 exe 路径，如果用户没提供路径就请使用默认参数： C:\\CloudMusic\\cloudmusic.exe
+    :return: 启动结果 json
+    """
+    return _open_cloud_music(exe_path)
+
+@mcp.tool()
+def search_and_play_mcp(keyword: str) -> dict:
+    """
+    搜索并播放指定歌曲。
+    :param keyword: 歌曲关键词
+    :return: 操作结果json
+    """
+    return _search_and_play(keyword)
+
+@mcp.tool()
+def play_and_pause_mcp() -> dict:
+    """
+    播放/暂停当前歌曲。
+    :return: 操作结果json
+    """
+    return _play_and_pause()
+
+@mcp.tool()
+def next_song() -> dict:
+    """
+    切换到下一首歌曲。
+    :return: 操作结果json
+    """
+    return _next_song()
+
+@mcp.tool()
+def pre_song() -> dict:
+    """
+    切换到上一首歌曲。
+    :return: 操作结果json
+    """
+    return _pre_song()
+
+
+def main():
+    mcp.run(transport="stdio")
+
+if __name__ == "__main__":
+    mcp.run(transport="sse")

ben_music_mcp-0.1.9/src/ben_music_mcp/action.py

@@ -0,0 +1,106 @@
+import platform
+
+if platform.system() == "Windows":
+    import uiautomation as auto
+    import time
+    import subprocess
+    import psutil
+    import pyautogui
+
+    exe_path0 = r'C:\CloudMusic\cloudmusic.exe'
+    def _open_cloud_music(exe_path: str = None):
+        """
+        打开网易云音乐客户端。
+        exe_path: 可选，指定客户端路径。如果输入则更新默认路径。
+        """
+        global exe_path0
+        try:
+            if exe_path:
+                exe_path0 = exe_path
+            path_to_use = exe_path0
+            found = False
+            for w in auto.GetRootControl().GetChildren():
+                pid = w.ProcessId
+                try:
+                    proc = psutil.Process(pid)
+                    if proc.name().lower() == 'cloudmusic.exe':
+                        w.SetActive()
+                        found = True
+                        break
+                except Exception:
+                    continue
+            if not found:
+                subprocess.Popen(path_to_use)
+                time.sleep(2)  # 等待程序启动
+            return {"code": 200, "msg": "网易云音乐已启动"}
+        except Exception as e:
+            return {"code": 500, "msg": f"启动失败: {e}"}
+
+    def _search_and_play(keyword:str, timeout:float=0.2):
+        try:
+            _open_cloud_music()
+            pyautogui.click(447, 43)  # 点击输入框
+            time.sleep(timeout)
+            auto.SendKeys(keyword)  # 输入搜索内容，这个还是uiautomation好用
+            time.sleep(timeout)
+            pyautogui.click(380, 42)  # 点击搜索框
+            time.sleep(timeout)
+            pyautogui.click(392, 190)  # 点击“单曲”
+            time.sleep(1)
+            pyautogui.doubleClick(402, 339)  # 双击“第一首”播放
+            return {"code": 200, "msg": f"已成功播放歌曲: {keyword}"}
+        except Exception as e:
+            return {"code": 500, "msg": f"播放歌曲失败: {e}"}
+
+    def _play_and_pause():
+        try:
+            _open_cloud_music()
+            pyautogui.click(961, 1028)  # 点击播放按钮
+            return {"code": 200, "msg": "成功【播放】/【暂停】"}
+        except Exception as e:
+            return {"code": 500, "msg": f"操作失败: {e}"}
+
+    def _next_song():
+        try:
+            _open_cloud_music()
+            pyautogui.click(1025, 1032)  # 点击下一首按钮
+            return {"code": 200, "msg": "切换下一首成功"}
+        except Exception as e:
+            return {"code": 500, "msg": f"操作失败: {e}"}
+
+    def _pre_song():
+        try:
+            _open_cloud_music()
+            pyautogui.click(894, 1028)  # 点击上一首按钮
+            return {"code": 200, "msg": "切换上一首成功"}
+        except Exception as e:
+            return {"code": 500, "msg": f"操作失败: {e}"}
+
+else:
+    exe_path0 = None
+    def _open_cloud_music(exe_path: str = None):
+        return {"code": 501, "msg": "本功能仅支持 Windows 环境，请本地 Local 使用 uvx ben-music-mcp@latest"}
+    
+    def _search_and_play(keyword: str, timeout: float = 0.2):
+        return {"code": 501, "msg": "本功能仅支持 Windows 环境，请本地 Local 使用 uvx ben-music-mcp@latest"}
+
+    def _play_and_pause():
+        return {"code": 501, "msg": "本功能仅支持 Windows 环境，请本地 Local 使用 uvx ben-music-mcp@latest"}
+
+    def _next_song():
+        return {"code": 501, "msg": "本功能仅支持 Windows 环境，请本地 Local 使用 uvx ben-music-mcp@latest"}
+
+    def _pre_song():
+        return {"code": 501, "msg": "本功能仅支持 Windows 环境，请本地 Local 使用 uvx ben-music-mcp@latest"}
+
+
+if __name__ == "__main__":
+    # _open_cloud_music()
+    
+    # _search_and_play("打上花火")
+    
+    # _play_and_pause()
+    
+    # _next_song()
+    
+    _pre_song()

ben_music_mcp-0.1.9/src/ben_music_mcp/cookie.txt

@@ -0,0 +1 @@
+{"MUSIC_A_T": "1762674143805", "MUSIC_R_T": "0", "MUSIC_A": "00FD2909A8CC993C4FB0FC90128C7E2E3EEC34146238C0F67438D16B51DB026C9AC74700E4270BCF0954B0454EDA13126BBD915DF4CF52EF21ACB5141059BEFA897B59C94F25484D47A8C8B257C322CB9D745805D39E61449D59DF795D936D9F5F628CE6E0D6610792EB91B0D34EBFB837357B9AC0135C97B18B1D6FB1EA248B5532FEFF6A34A5C57B4EDE76C36AACF86A542A7358C44E0F2978A3B7AA852F2A84DA48857A5CAAE3FA2D4968232C727BFD96CD7D7E7479829C726EC940B1880EFD01740C665B517699FAAEF1CA3BDD92E049A36AB793A15AD9AD75E4D691D4D821E363CAE7BF3AC9586A653999810747C974239EC1E43944EB679B3DC92CFF113BDBC9279CCDCD5271C55DD18FE58847F6AF6D5E12D1D8BB8417D99B2AEDF13B4EC9097EE893ABD6BBC56E37187D2386D061DE4288B289AD7F4068E488B691682F61F170D1DDB0E6D84A679E49677A1E529C96FE9540E0B5527B1D23C956FEAB3CB6B3647B749B1CAE39EE70CC6FFC06E5F4AC33DA9470E856C1391FD7006FB487C9537E4D11B2D469A78615B32771CAE5A725D8FD8FA172E865A236F487B665817AE5F57F4AF8781F2663CA0E5780CBBF4474D616D068125C6EAFC1741C5B844F8BB6621037BA47FC0CD9E48FA63499730DF294E62E3A2CF99319D6DD778B573CCB7B99B2AFC4CC9035540E3864862E2707B4898BD831AF07C4F0774ED9AFA3F96B94079C3F48D262C4898BD0A3E39016", "__csrf": "eabbb81b921eb9637c0b389245b3a0dc", "MUSIC_R_U": "00F9CF8A93CB06AEC0A041DB4FC98922D18884F91B648A3F78CC43943902835DB940DC984AC33ED14A019B44DCDB707C2FA8F2ED50EC556FB93B675A320C20F5E39A3EA15488819D77A922244FB3B663B4"}

ben_music_mcp-0.1.9/src/ben_music_mcp/server.py

@@ -0,0 +1,5 @@
+from . import mcp
+
+
+if __name__ == "__main__":
+    mcp.run(transport="sse")

ben_music_mcp-0.1.9/src/ben_music_mcp/styleList.json

@@ -0,0 +1,26 @@
+[{"tagId": 1000, "tagName": "流行"},
+{"tagId": 1017, "tagName": "嘻哈说唱"},
+{"tagId": 1015, "tagName": "电子"},
+{"tagId": 1028, "tagName": "R&B"},
+{"tagId": 1008, "tagName": "摇滚"},
+{"tagId": 1003, "tagName": "民谣"},
+{"tagId": 10119, "tagName": "国风"},
+{"tagId": 1010, "tagName": "原声带"},
+{"tagId": 1026, "tagName": "儿童"},
+{"tagId": 79088, "tagName": "慢摇DJ"},
+{"tagId": 1001, "tagName": "中国传统特色"},
+{"tagId": 1022, "tagName": "古典"},
+{"tagId": 1011, "tagName": "爵士"},
+{"tagId": 1252, "tagName": "二次元"},
+{"tagId": 1006, "tagName": "轻音乐"},
+{"tagId": 1029, "tagName": "放克"},
+{"tagId": 1263, "tagName": "世界乐器体裁"},
+{"tagId": 1077, "tagName": "乡村"},
+{"tagId": 1007, "tagName": "新世纪"},
+{"tagId": 152124, "tagName": "朋克"},
+{"tagId": 1071, "tagName": "拉丁音乐"},
+{"tagId": 1041, "tagName": "金属"},
+{"tagId": 1037, "tagName": "蓝调"},
+{"tagId": 1014, "tagName": "另类/独立"},
+{"tagId": 1043, "tagName": "雷鬼"},
+{"tagId": 1012, "tagName": "世界音乐"}]

ben_music_mcp-0.1.9/src/ben_music_mcp/tool.py

@@ -0,0 +1,520 @@
+import subprocess
+import requests
+
+# 全局变量保存 cookie
+global_cookie = {}
+
+import os
+import json
+
+def _save_cookie_to_file(cookie: dict, filename: str = "cookie.txt"):
+    """将cookie保存到文件"""
+    path = os.path.join(os.path.dirname(__file__), filename)
+    with open(path, "w", encoding="utf-8") as f:
+        f.write(json.dumps(cookie, ensure_ascii=False))
+
+def _load_cookie_from_file(filename: str = "cookie.txt") -> dict:
+    """从文件读取cookie"""
+    path = os.path.join(os.path.dirname(__file__), filename)
+    if not os.path.exists(path):
+        return {}
+    try:
+        with open(path, "r", encoding="utf-8") as f:
+            return json.loads(f.read())
+    except Exception:
+        return {}
+
+def _get_cookie() -> dict:
+    """获取当前cookie（优先文件）"""
+    global global_cookie
+    if global_cookie:
+        return global_cookie
+    cookie = _load_cookie_from_file()
+    global_cookie = cookie
+    return cookie
+
+def _hello() -> dict:
+    """方法注释"""
+    return {"code": 200, "msg": "success", "data": "我是哈尔滨工业大学的学生，我叫张三，学号是123456。"}
+
+def _get_song_info(keywords: str) -> dict:
+    """
+    搜索歌曲，返回json格式
+    :param keywords: 歌曲关键词
+    :return: 歌曲信息json
+    """
+    url = f"https://ncm.nekogan.com/search?keywords={keywords}"
+    try:
+        resp = requests.get(url, timeout=5)
+        resp.raise_for_status()
+        data = resp.json()
+        if "result" in data and "songs" in data["result"]:
+            songs = data["result"]["songs"]
+            if not songs:
+                return {"code": 404, "msg": "未找到相关歌曲", "data": {}}
+            song = songs[0]
+            return {
+                "code": 200,
+                "msg": "success",
+                "data": {
+                    "id": song.get("id", "未知"),
+                    "name": song.get("name", "未知"),
+                    "artists": [a["name"] for a in song.get("artists", [])],
+                    "album": song.get("album", {}).get("name", "未知"),
+                    "alias": song.get("alias", []),
+                    "transNames": song.get("transNames", []),
+                    "duration": song.get("duration", 0),
+                    "fee": song.get("fee", 0),
+                    "mvid": song.get("mvid", 0)
+                }
+            }
+        else:
+            return {"code": 404, "msg": "未找到相关歌曲", "data": {}}
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败: {e}", "data": {}}
+
+def _get_song_id(keywords: str) -> dict:
+    """
+    搜索歌曲，返回第一个歌曲ID，json格式
+    :param keywords: 歌曲关键词
+    :return: 歌曲ID json
+    """
+    result = _get_song_info(keywords)
+    if result.get("code") == 200 and "id" in result.get("data", {}):
+        return {"code": 200, "msg": "success", "id": str(result["data"]["id"])}
+    return {"code": 404, "msg": "未找到相关歌曲ID", "id": ""}
+
+def _lyric(keywords: str) -> dict:
+    """先获取歌曲id，再查歌词，返回json"""
+    song_id_json = _get_song_id(keywords)
+    song_id = song_id_json.get("id", "")
+    if not song_id or not song_id.isdigit():
+        return {"code": 404, "msg": f"未找到歌曲ID，原因：{song_id_json}", "data": ""}
+    url = f"https://ncm.nekogan.com/lyric?id={song_id}"
+    try:
+        resp = requests.get(url, timeout=5)
+        resp.raise_for_status()
+        data = resp.json()
+        lyric_text = data.get("lrc", {}).get("lyric", "")
+        if lyric_text:
+            return {"code": 200, "msg": "success", "data": lyric_text}
+        else:
+            return {"code": 404, "msg": "未找到歌词。", "data": ""}
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败 {e}", "data": ""}
+
+
+def _search_artist(keyword: str) -> dict:
+    """
+    搜索歌手，返回json格式
+    :param keyword: 歌手关键词
+    :return: 歌手信息json
+    """
+    url = f"https://ncm.nekogan.com/ugc/artist/search?keyword={keyword}"
+    try:
+        cookie = _get_cookie()
+        resp = requests.get(url, timeout=10, cookies=cookie)
+        resp.raise_for_status()
+        data = resp.json()
+        data_field = data.get("data")
+        if not data_field or "list" not in data_field:
+            return {"code": 404, "msg": "未找到相关歌手", "data": {}}
+        artists = data_field.get("list", [])
+        if not artists:
+            return {"code": 404, "msg": "未找到相关歌手", "data": {}}
+        artist = artists[0]
+        return {
+            "code": 200,
+            "msg": "success",
+            "data": {
+                "artistName": artist.get("artistName", "未知"),
+                "artistId": artist.get("artistId", "未知"),
+                "avatar": artist.get("artistAvatarPicUrl", "")
+            }
+        }
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败: {e}", "data": {}}
+
+def _get_artist_id(keyword: str) -> dict:
+    """
+    根据关键词搜索歌手，返回第一个歌手ID，json格式
+    :param keyword: 歌手关键词
+    :return: 歌手ID json
+    """
+    result = _search_artist(keyword)
+    if result.get("code") == 200 and "artistId" in result.get("data", {}):
+        return {"code": 200, "msg": "success", "id": str(result["data"]["artistId"])}
+    return {"code": 404, "msg": "未找到相关歌手ID", "id": ""}
+
+
+def _get_artist_info(keyword: str) -> dict:
+    """
+    根据关键词获取歌手详细信息，先查id再查详情，返回json
+    :param keyword: 歌手关键词
+    :return: 歌手详细信息json
+    """
+    id_json = _get_artist_id(keyword)
+    artist_id = id_json.get("id", "")
+    if not artist_id or not artist_id.isdigit():
+        return {"code": 404, "msg": f"未找到歌手ID，原因：{id_json}", "data": {}}
+    url = f"https://ncm.nekogan.com/ugc/artist/get?id={artist_id}"
+    try:
+        cookie = _get_cookie()
+        resp = requests.get(url, timeout=5, cookies=cookie)
+        resp.raise_for_status()
+        data = resp.json()
+        return {"code": 200, "msg": "success", "data": data}
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败: {e}", "data": {}}
+
+def _get_artist_hot_songs(keyword: str) -> dict:
+    """
+    根据关键词获取歌手最火的50首歌曲，先查id再查热门歌曲，返回json
+    :param keyword: 歌手关键词
+    :return: 热门歌曲json
+    """
+    id_json = _get_artist_id(keyword)
+    artist_id = id_json.get("id", "")
+    if not artist_id or not artist_id.isdigit():
+        return {"code": 404, "msg": f"未找到歌手ID，原因：{id_json}", "data": []}
+    url = f"https://ncm.nekogan.com/artist/top/song?id={artist_id}"
+    try:
+        cookie = _get_cookie()
+        resp = requests.get(url, timeout=5, cookies=cookie)
+        resp.raise_for_status()
+        data = resp.json()
+        return {"code": 200, "msg": "success", "data": data}
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败: {e}", "data": []}
+
+
+def _get_music_url(keywords: str, level: str = "standard") -> dict:
+    """
+    根据关键词获取音乐播放url，先查歌曲id再查url，返回json
+    :param keywords: 歌曲关键词
+    :param level: 音质等级
+    :return: 音乐url json
+    """
+    id_json = _get_song_id(keywords)
+    song_id = id_json.get("id", "")
+    if not song_id or not song_id.isdigit():
+        return {"code": 404, "msg": f"未找到歌曲ID，原因：{id_json}", "data": {}}
+    url = f"https://ncm.nekogan.com/song/url/v1?id={song_id}&level={level}"
+    try:
+        resp = requests.get(url, timeout=5)
+        resp.raise_for_status()
+        data = resp.json()
+        return {"code": 200, "msg": "success", "data": data}
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败: {e}", "data": {}}
+
+
+def _get_song_comment(keywords: str) -> dict:
+    """
+    根据关键词获取歌曲评论，只保留有用信息，返回json
+    :param keywords: 歌曲关键词
+    :return: 歌曲评论json
+    """
+    id_json = _get_song_id(keywords)
+    song_id = id_json.get("id", "")
+    if not song_id or not song_id.isdigit():
+        return {"code": 404, "msg": f"未找到歌曲ID，原因：{id_json}", "data": []}
+    url = f"https://ncm.nekogan.com/comment/music?id={song_id}"
+    try:
+        resp = requests.get(url, timeout=5)
+        resp.raise_for_status()
+        data = resp.json()
+        hot_comments = data.get("hotComments", [])
+        # 只保留有用字段
+        result = []
+        for c in hot_comments:
+            user = c.get("user", {})
+            result.append({
+                "nickname": user.get("nickname", "未知"),
+                "content": c.get("content", ""),
+                "likedCount": c.get("likedCount", 0),
+                "timeStr": c.get("timeStr", "")
+            })
+        return {"code": 200, "msg": "success", "data": result}
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败: {e}", "data": []}
+
+
+def _get_playlist(id):
+    """
+    获取歌单详情，只返回关键字段。
+    参数: id (歌单id)
+    返回: JSON
+    """
+    url = f"https://ncm.nekogan.com/playlist/detail?id={id}"
+    try:
+        resp = requests.get(url, timeout=10)
+        data = resp.json()
+        if data.get("code") != 200 or "playlist" not in data:
+            return {"code": 500, "msg": "请求失败"}
+        pl = data["playlist"]
+        result = {
+            "id": pl.get("id"),
+            "name": pl.get("name"),
+            "coverImgUrl": pl.get("coverImgUrl"),
+            "userId": pl.get("userId"),
+            "createTime": pl.get("createTime"),
+            "trackCount": pl.get("trackCount"),
+            "playCount": pl.get("playCount"),
+            "subscribedCount": pl.get("subscribedCount"),
+            "description": pl.get("description"),
+            "tags": pl.get("tags", []),
+            "tracks": []
+        }
+        for t in pl.get("tracks", []):
+            track = {
+                "id": t.get("id"),
+                "name": t.get("name"),
+                "ar": [a.get("name") for a in t.get("ar", [])],
+                "al": t.get("al", {}).get("name"),
+                "alia": t.get("alia", [])
+            }
+            result["tracks"].append(track)
+        return result
+    except Exception as e:
+        return {"code": 500, "msg": str(e)}
+
+
+def _get_toplist(name: str) -> dict:
+    """
+    根据排行榜名获取榜单详情（先查id再查_get_playlist）
+    :param name: 榜单名称
+    :return: 榜单详情json
+    """
+    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", [])
+        match = next((item for item in toplists if item.get("name") == name), None)
+        if not match:
+            return {"code": 404, "msg": f"未找到榜单: {name}"}
+        return _get_playlist(match["id"])
+    except Exception as e:
+        return {"code": 500, "msg": f"读取榜单失败: {e}"}
+
+
+def _get_similar_songs(keywords: str) -> dict:
+    """
+    根据关键词获取相似音乐（先查id再查/simi/song）
+    :param keywords: 歌曲关键词
+    :return: 相似音乐json
+    """
+    id_json = _get_song_id(keywords)
+    song_id = id_json.get("id", "")
+    if not song_id or not song_id.isdigit():
+        return {"code": 404, "msg": f"未找到歌曲ID，原因：{id_json}", "data": []}
+    url = f"https://ncm.nekogan.com/simi/song?id={song_id}"
+    try:
+        resp = requests.get(url, timeout=5)
+        resp.raise_for_status()
+        data = resp.json()
+        songs = data.get("songs", [])
+        result = []
+        for s in songs:
+            result.append({
+                "id": s.get("id"),
+                "name": s.get("name"),
+                "artists": [a.get("name") for a in s.get("artists", [])],
+                "album": s.get("album", {}).get("name"),
+                "duration": s.get("duration")
+            })
+        return {"code": 200, "msg": "success", "data": result}
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败: {e}", "data": []}
+
+
+def _get_style_songs(style_name: str) -> dict:
+    """
+    根据曲风名获取对应曲风id，再查 /style/song?tagId=xxx，返回歌曲列表。
+    :param style_name: 曲风名
+    :return: 歌曲列表json
+    """
+
+    # 读取 styleList.json
+    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)
+    except Exception as e:
+        return {"code": 500, "msg": f"读取曲风列表失败: {e}", "data": {}}
+
+    tag_id = None
+    for item in style_list:
+        if item.get("tagName") == style_name:
+            tag_id = item.get("tagId")
+            break
+    if not tag_id:
+        return {"code": 404, "msg": f"未找到曲风: {style_name}", "data": {}}
+
+    url = f"https://ncm.nekogan.com/style/song?tagId={tag_id}"
+    try:
+        cookie = _get_cookie()
+        resp = requests.get(url, timeout=10, cookies=cookie)
+        resp.raise_for_status()
+        data = resp.json()
+        page = data.get("page", {})
+        songs = data.get("songs")
+        # 自动适配嵌套结构
+        if songs is None:
+            for v in data.values():
+                if isinstance(v, dict) and "songs" in v:
+                    songs = v["songs"]
+                    break
+                elif isinstance(v, list):
+                    for item in v:
+                        if isinstance(item, dict) and "songs" in item:
+                            songs = item["songs"]
+                            break
+        if songs is None:
+            songs = []
+        # 只保留关键信息
+        result = []
+        for s in songs:
+            if isinstance(s, dict):
+                result.append({
+                    "id": s.get("id"),
+                    "name": s.get("name"),
+                    "artists": [a.get("name") for a in s.get("ar", [])],
+                    "album": s.get("al", {}).get("name"),
+                    "duration": s.get("dt")
+                })
+        return {"code": 200, "msg": "success", "data": result}
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败: {e}", "data": {}}
+
+
+
+def _get_uid(nickname: str) -> dict:
+    """
+    根据用户昵称获取其uid
+    :param nickname: 用户昵称
+    :return: 用户uid json
+    """
+    url = f"https://ncm.nekogan.com/get/userids?nicknames={nickname}"
+    try:
+        resp = requests.get(url, timeout=5)
+        resp.raise_for_status()
+        data = resp.json()
+        # 适配 nicknames 字段结构
+        nick_dict = data.get("nicknames", {})
+        if not nick_dict:
+            return {"code": 404, "msg": "未找到用户", "data": {}}
+        # 取第一个昵称和uid
+        for n, uid in nick_dict.items():
+            return {"code": 200, "msg": "success", "data": {"uid": uid, "nickname": n}}
+        return {"code": 404, "msg": "未找到用户", "data": {}}
+    except Exception as e:
+        return {"code": 500, "msg": f"请求失败: {e}", "data": {}}
+
+def _get_user_playlist(nickname: str) -> dict:
+    """
+    输入用户昵称，获取用户歌单（只保留必要字段）
+    :param nickname: 用户昵称
+    :return: 歌单列表json
+    """
+    # 第一步：获取uid
+    uid_result = _get_uid(nickname)
+    if uid_result.get("code") != 200 or "uid" not in uid_result.get("data", {}):
+        return {"code": 404, "msg": f"未找到用户: {nickname}", "data": []}
+    uid = uid_result["data"]["uid"]
+    # 第二步：获取歌单
+    url = f"https://ncm.nekogan.com/user/playlist?uid={uid}"
+    try:
+        resp = requests.get(url, timeout=5)
+        resp.raise_for_status()
+        data = resp.json()
+        playlists = data.get("playlist", [])
+        result = []
+        for pl in playlists:
+            result.append({
+                "id": pl.get("id"),
+                "name": pl.get("name"),
+                "coverImgUrl": pl.get("coverImgUrl"),
+                "trackCount": pl.get("trackCount"),
+                "playCount": pl.get("playCount"),
+                "creator": {
+                    "userId": pl.get("creator", {}).get("userId"),
+                    "nickname": pl.get("creator", {}).get("nickname"),
+                    "avatarUrl": pl.get("creator", {}).get("avatarUrl")
+                }
+            })
+        return {"code": 200, "msg": "success", "data": result}
+    except Exception as e:
+        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:
+    url = "https://ncm.nekogan.com/register/anonimous"
+    try:
+        resp = requests.get(url, timeout=10)
+        resp.raise_for_status()
+        data = resp.json()
+        cookie = resp.cookies.get_dict()
+        global global_cookie
+        global_cookie = cookie
+        _save_cookie_to_file(cookie)
+        return {"code": 200, "msg": "游客登录成功", "cookie": cookie, "data": data}
+    except Exception as e:
+        return {"code": 500, "msg": f"游客登录失败: {e}", "cookie": {}, "data": {}}
+
+def _login_refresh() -> dict:
+    url = "https://ncm.nekogan.com/login/refresh"
+    try:
+        resp = requests.get(url, timeout=10)
+        resp.raise_for_status()
+        data = resp.json()
+        cookie = resp.cookies.get_dict()
+        return {"code": 200, "msg": "登录状态刷新成功", "cookie": cookie, "data": data}
+    except Exception as e:
+        return {"code": 500, "msg": f"刷新登录失败: {e}", "cookie": {}, "data": {}}
+
+
+def _start_netease_music(exe_path: str) -> dict:
+    """
+    启动本地网易云音乐客户端
+    :param exe_path: 网易云音乐客户端的 exe 路径
+    :return: 启动结果 json
+    """
+    try:
+        subprocess.Popen(exe_path)
+        return {"code": 200, "msg": "网易云音乐已启动", "exe_path": exe_path}
+    except Exception as e:
+        return {"code": 500, "msg": f"启动失败: {e}", "exe_path": exe_path}

ben_music_mcp-0.1.9/src/ben_music_mcp/toplist.json

@@ -0,0 +1,65 @@
+{
+  "toplists": [
+    {"name": "飙升榜", "id": 19723756},
+    {"name": "新歌榜", "id": 3779629},
+    {"name": "原创榜", "id": 2884035},
+    {"name": "热歌榜", "id": 3778678},
+    {"name": "网易云中文说唱榜", "id": 991319590},
+    {"name": "网易云古典榜", "id": 71384707},
+    {"name": "网易云电音榜", "id": 1978921795},
+    {"name": "网易云全球说唱榜", "id": 14028249541},
+    {"name": "潮流风向榜", "id": 13372522766},
+    {"name": "音乐合伙人推荐榜", "id": 12911403728},
+    {"name": "音乐合伙人热歌榜", "id": 12911589513},
+    {"name": "音乐合伙人留名榜", "id": 12911619970},
+    {"name": "音乐合伙人高分新歌榜", "id": 12911379734},
+    {"name": "音乐合伙人高分榜", "id": 12768855486},
+    {"name": "黑胶VIP爱听榜", "id": 5453912201},
+    {"name": "网易云ACG榜", "id": 71385702},
+    {"name": "网易云韩语榜", "id": 745956260},
+    {"name": "UK排行榜周榜", "id": 180106},
+    {"name": "美国Billboard榜", "id": 60198},
+    {"name": "Beatport全球电子舞曲榜", "id": 3812895},
+    {"name": "KTV唛榜", "id": 21845217},
+    {"name": "日本Oricon榜", "id": 60131},
+    {"name": "网易云欧美热歌榜", "id": 2809513713},
+    {"name": "网易云欧美新歌榜", "id": 2809577409},
+    {"name": "蛋仔派对听歌榜", "id": 8532443277},
+    {"name": "AI歌曲榜", "id": 9651277674},
+    {"name": "黑胶VIP新歌榜", "id": 7785123708},
+    {"name": "黑胶VIP热歌榜", "id": 7785066739},
+    {"name": "黑胶VIP爱搜榜", "id": 7785091694},
+    {"name": "实时热度榜", "id": 8246775932},
+    {"name": "法国 NRJ Vos Hits 周榜", "id": 27135204},
+    {"name": "网易云ACG动画榜", "id": 3001835560},
+    {"name": "网易云ACG游戏榜", "id": 3001795926},
+    {"name": "网易云ACG VOCALOID榜", "id": 3001890046},
+    {"name": "网易云日语榜", "id": 5059644681},
+    {"name": "网易云摇滚榜", "id": 5059633707},
+    {"name": "网易云国风榜", "id": 5059642708},
+    {"name": "潜力爆款榜", "id": 5338990334},
+    {"name": "网易云民谣榜", "id": 5059661515},
+    {"name": "听歌识曲榜", "id": 6688069460},
+    {"name": "网络热歌榜", "id": 6723173524},
+    {"name": "俄语榜", "id": 6732051320},
+    {"name": "越南语榜", "id": 6732014811},
+    {"name": "中文慢摇DJ榜", "id": 6886768100},
+    {"name": "俄罗斯top hit流行音乐榜", "id": 6939992364},
+    {"name": "泰语榜", "id": 7095271308},
+    {"name": "BEAT排行榜", "id": 7356827205},
+    {"name": "星云榜VOL.30 Wolf Alice新专来袭，人生应该拥有不一样的颜色", "id": 7325478166},
+    {"name": "LOOK直播歌曲榜", "id": 7603212484},
+    {"name": "赏音榜", "id": 7775163417},
+    {"name": "黑胶VIP限免榜", "id": 12344472377},
+    {"name": "吉利车友爱听榜", "id": 12717025277},
+    {"name": "昊铂车友爱听榜", "id": 10131772880},
+    {"name": "埃安车友爱听榜", "id": 10162841534},
+    {"name": "欧美R&B榜", "id": 12225155968},
+    {"name": "理想车友爱听榜", "id": 8703052295},
+    {"name": "比亚迪车友爱听榜", "id": 8702582160},
+    {"name": "蔚来车友爱听榜", "id": 8703220480},
+    {"name": "极氪车友爱听榜", "id": 8702982391},
+    {"name": "特斯拉车友爱听榜", "id": 8703179781},
+    {"name": "乐夏榜", "id": 8661209031}
+  ]
+}