benyinyinyuezhushou
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"ben_mcp_server": {
"args": [
"ben-music-mcp@latest"
],
"command": "uvx"
}
}
}可用工具 （23 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
hello
version=0.1.20 该方法无需参数
该工具无需必填参数，直接调用即可
get_song_info 1 个参数 需填 1 项
根据关键词搜索歌曲信息
必填参数：keywords
lyric 1 个参数 需填 1 项
根据歌名关键词搜索歌词
必填参数：keywords
get_music_url 2 个参数 需填 1 项
根据关键词获取音乐在线试听url
必填参数：keywords
get_song_comment 1 个参数 需填 1 项
根据歌名关键词获取歌曲评论
必填参数：keywords
get_similar_songs 1 个参数 需填 1 项
根据关键词获取相似音乐
必填参数：keywords
get_style_songs 1 个参数 需填 1 项
根据曲风名返回歌曲列表。允许查询的曲风可以调用 return_stylelist 获取参考。
必填参数：style_name
search_artist 1 个参数 需填 1 项
根据关键词搜索歌手简要信息
必填参数：keyword
get_artist_info 1 个参数 需填 1 项
根据关键词获取歌手详细信息
必填参数：keyword
get_artist_hot_songs 1 个参数 需填 1 项
根据关键词获取歌手最火的50首歌曲
必填参数：keyword
get_playlist 1 个参数 需填 1 项
根据歌单id获取歌单详情
必填参数：id
get_toplist 1 个参数 需填 1 项
根据排行榜名字获取榜单详情。支持查询排行榜可以调用return_toplist_name获取参考。
必填参数：name
get_user_playlist 1 个参数 需填 1 项
输入用户昵称，获取用户歌单（含有歌单id）
必填参数：nickname
return_stylelist
返回所有风格名称，获取所有歌曲风格 该方法无需参数
该工具无需必填参数，直接调用即可
return_toplist_name
返回所有排行榜名称 该方法无需参数
该工具无需必填参数，直接调用即可
export_playlist_html 2 个参数 需填 1 项
根据歌单id生成精美HTML，path不为None则保存到相应文件路径，否则直接返回html字符串。 文件路径应该类似C:\Users\Ben\Desktop\playlist.html
必填参数：id
export_playlist_csv 2 个参数 需填 1 项
根据歌单id导出为CSV，path不为None则保存到文件，否则直接返回csv字符串 文件路径应该类似C:\Users\Ben\Desktop\playlist.csv
必填参数：id
open_cloud_music 1 个参数
启动本地网易云音乐客户端。此方法仅支持本地调用。 :param exe_path: 网易云音乐的 exe 路径
该工具无需必填参数，直接调用即可
search_and_play_mcp 1 个参数 需填 1 项
搜索并播放指定歌曲。此方法仅支持本地调用。 建议先调用open_cloud_music打开网易云客户端。
必填参数：keyword
play_and_pause_mcp
播放/暂停当前歌曲。此方法仅支持本地调用。 该方法无需参数
该工具无需必填参数，直接调用即可
next_song
切换到下一首歌曲。此方法仅支持本地调用。 该方法无需参数
该工具无需必填参数，直接调用即可
pre_song
切换到上一首歌曲。此方法仅支持本地调用。 该方法无需参数
该工具无需必填参数，直接调用即可
songs_recognize 2 个参数 需填 2 项
听歌识曲。此方法仅支持本地调用。 :param audio_path: 本地音频文件路径。建议不要超过20秒。 :param api_key: RapidAPI key，(https://rapidapi.com/tipsters/api/shazam-core)
必填参数：audio_path、api_key
服务介绍
ben-music-mcp
本产品是一套面向开发者和智能体的音乐信息服务工具，专注于高效、专业的音乐数据获取与个性化推荐。所有接口均采用标准 JSON 格式，便于自动化集成与二次开发。
产品功能概览
歌曲与歌手信息
- 歌曲检索：支持通过关键词精准获取歌曲详情，包括名称、艺人、专辑等核心信息。
- 歌词查询：一键获取任意歌曲的完整歌词文本。
- 歌手检索与详情：快速定位歌手并获取其详细资料及代表作品。
- 热门歌曲榜单：自动获取歌手最受欢迎的曲目列表。
音乐播放与评论
- 在线试听链接：根据需求获取不同音质等级的音乐播放地址。
- 热门评论提取：智能筛选并返回歌曲的高质量评论，便于用户快速了解口碑。
- 相似歌曲推荐：基于音乐特征，智能推荐与目标歌曲风格相近的作品。
歌单与榜单服务
- 歌单详情查询：支持按歌单编号获取完整歌单信息，涵盖曲目、封面、创建者等。
- 排行榜检索：覆盖主流及特色音乐榜单，助力发现最新流行趋势。
- 用户歌单获取：根据用户昵称，自动获取其公开歌单列表。
曲风与标签体系
- 曲风分类查询：支持按风格名称获取对应曲风下的热门歌曲。
- 风格列表获取：一键获取所有可选音乐风格，便于个性化筛选。
- 榜单名称获取：快速获取所有可用排行榜名称，提升榜单检索效率。
用户与客户端服务
- 用户身份查询：通过昵称获取用户唯一标识，便于个性化服务。
- 本地客户端启动：支持远程启动本地网易云音乐客户端，提升桌面体验。
接口返回格式
所有接口均返回标准结构，便于前后端集成：
{
"code": 200, // 状态码，200 表示成功
"msg": "success", // 状态信息
"data": {...} // 具体数据内容
}
技术与环境要求
- Python 3.8 及以上
- requests
- fastmcp
