ben-music-mcp 0.1.1__tar.gz

ben_music_mcp-0.1.1/PKG-INFO

@@ -0,0 +1,99 @@
+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

@@ -0,0 +1,83 @@
+# 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/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "ben-music-mcp"
+version = "0.1.1"
+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"
+]
+
+[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.1/src/ben_music_mcp/__init__.py

@@ -0,0 +1,204 @@
+
+
+from fastmcp import FastMCP
+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,
+    global_cookie
+)
+
+mcp = FastMCP("MCPService")
+
+
+@mcp.tool
+def hello() -> dict:
+    """方法注释"""
+    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:
+    """
+    根据歌名关键词搜索歌词（内部先获取歌曲ID）
+    :param keywords: 歌曲关键词
+    :return: 歌词文本
+    """
+    return _lyric(keywords)
+
+
+@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
+    :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:
+    """
+    根据歌单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_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_user_playlist(nickname: str) -> dict:
+    """
+    输入用户昵称，获取用户歌单（只保留必要字段）
+    :param nickname: 用户昵称
+    :return: 歌单列表json
+    """
+    return _get_user_playlist(nickname)
+
+
+
+
+
+@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)
+
+def main():
+    mcp.run(transport="stdio")
+
+if __name__ == "__main__":
+    mcp.run(transport="stdio")

ben_music_mcp-0.1.1/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.1/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.1/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.1/src/ben_music_mcp/tool.py

@@ -0,0 +1,491 @@
+
+
+import subprocess
+import requests
+
+# 全局变量保存 cookie
+global_cookie = {}
+
+import os
+import json
+
+def _save_cookie_to_file(cookie: dict, filename: str = "cookie.txt"):
+    """将cookie保存到文件"""
+    with open(filename, "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"""
+    if not os.path.exists(filename):
+        return {}
+    try:
+        with open(filename, "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=5, 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:
+        with open("toplist.json", "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:
+        with open("styleList.json", "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")
+            print("tag_id: ",tag_id)
+            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()
+        print("完整响应:", data)
+        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")
+                })
+        print("最终精简songs:", result)
+        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 _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.1/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}
+  ]
+}