Claude · Codex · Gemini CLI
音乐库 MCP 服务器
将 Claude 或 Codex 连接到 MyMusik。借助 AI 管理标签、文件夹和播放列表,控制播放、剪切音轨,以及导入或导出音乐。

从 Insights 连接 Claude 或 Codex
首次连接时,请让智能体列出音乐库中的三张专辑,再到 MyMusik 的专辑页面核对结果。
- 打开 MyMusik,前往 Insights(/insights),找到“连接设备”。
- 选择盾牌图标,设置权限和访问时长,然后选择“应用”。要先了解音乐库,可以从“只读”权限开始。
- 选择“复制智能体提示词”(小屏幕上显示为“AI 智能体”)。每次复制都会创建一个新的单次使用邀请。
- 运行 mymusik-mcp pair,只粘贴包含 #grant= 的邀请链接。
- 请助手列出 MyMusik 音乐库中的三张专辑。
保持 MyMusik 运行。智能体需要 MCP 或 HTTP 工具,并且必须能够通过网络访问应用。
用 AI 控制音乐应用
让 AI 参与音乐库管理的整个流程:查找音轨、整理收藏、编辑音频和聆听音乐。MyMusik 的音乐 MCP 服务器会根据你选择的权限,让智能体访问应用操作。描述你想要的结果,智能体就可以组合多个操作来完成任务。
这些只是示例请求,并不代表自动执行的操作或保证得到的选曲。如需在变更前确认,请要求先查看建议的修改;连接实际能做什么取决于权限。
无需逐页浏览即可查找音乐
“在我的音乐库中查找 [artist] 的专辑,并列出音轨。”让智能体搜索歌曲、专辑、艺术家、播放列表和应用管理的文件夹,再协助你选择。
边工作,边听音乐
“播放 [playlist],等我提出要求时再暂停。”获得播放权限后,智能体可以在你继续对话时操作播放器和播放队列。
通过对话创建播放列表
“从这些艺术家的作品中推荐 12 首歌。先让我查看选择,等我同意后,再保存为‘工作日’。”让智能体收集音轨,并使用音乐库编辑权限创建播放列表。
管理整个音乐库的标签
“为这些歌曲和专辑添加‘公路旅行’标签,同时保留现有标签。”你可以为支持的音乐项目创建、重命名、分配和移除音乐库标签,按自己的分类整理收藏。
创建和整理嵌套文件夹
“创建‘公路旅行’文件夹,在其中添加‘夏日’子文件夹,再加入这些专辑。”创建、重命名和移动应用文件夹及其中的条目。这些文件夹用于整理音乐库引用,不会移动原始文件。
更新音轨和专辑信息
“列出专辑名称有误的音轨,再应用我确认的更正。”编辑受支持的音乐库元数据,让整个收藏中的名称保持一致。
用 AI 导入、剪切和导出音乐
将一项完整的音乐任务交给智能体,让它调用应用的导入、音频编辑和导出工具。它可以检查任务进度,并在对话中报告结果。
选择“自定义访问”,并包含整个任务所需的资源组。例如,编辑音频并创建歌曲可能同时需要“导入与文件”和“音乐库”权限。应用和智能体还必须支持保存或下载生成的文件。
导入音乐并跟踪进度
“导入这个文件夹中的音频,检查结果,并告诉我哪些音轨需要处理。”可使用可读取的文件、文件夹或受支持的音频 URL。运行 MyMusik 的设备必须能够访问这些来源;音轨是自动接受还是需要审核,取决于导入设置。
剪切、修剪或提取音轨
“将这首歌的 00:30 到 01:00 提取为一首独立歌曲,并保留原件。”使用精确的时间范围来删除片段,或据此创建新音轨。音频编辑需要有效的时间范围和可编辑的本地音频。
导出播放列表和音乐收藏
“将这个播放列表导出为 M3U8,并把其中的音轨打包成 ZIP。”你可以导出播放列表引用,或将专辑、播放列表及音乐库文件夹中的歌曲打包为带标签的 MP3 音频。ZIP 导出最多支持 1,000 首音轨,并要求音频可导出。M3U8 文件引用媒体位置,因此在其他地方使用时,仍需能够访问这些文件或 URL。
决定授予多少访问权限
使用连接卡片上的盾牌图标,为任务选择合适的访问权限。每次执行操作时,应用都会检查会话权限。
更改所选权限不会改变已有会话。请复制新的 AI 提示词,并使用新邀请重新连接。提示词可提供对应用的私密访问,请仅与信任的智能体分享。
只读
在不允许修改的前提下,浏览和汇总有权访问的音乐库信息。可先用此权限检查连接并讨论计划。
远程播放
允许使用管理聆听所需的播放器和队列控制功能。此预设还会授予整个公开 API 的读取权限。
音乐库编辑器
允许对音轨、专辑、艺术家、播放列表、标签和应用文件夹进行受支持的修改。用于整理收藏和更新音乐库信息。
导入管理器
允许执行导入、音频编辑、归档和文件操作。如果工作流程还会修改音乐库项目,可能需要额外的“音乐库”权限。
自定义访问
组合“播放”“音乐库”和“导入与文件”资源组,并为任务选择所需的访问级别,让一个智能体即可完成跨应用功能的工作流程。
通过 MCP 用 AI 管理音乐库
MCP 是 Model Context Protocol(模型上下文协议)的缩写。MyMusik 将文档中说明的应用操作公开为智能体可发现和使用的工具。智能体可以查找与你的请求相关的控制项,并从应用获取结果。
应用控制仅涵盖权限范围内公开的 API 操作,不提供对电脑鼠标和键盘的通用控制。
减少手动设置
复制的提示词包含邀请、连接说明、权限和恢复步骤,无需为每一项音乐任务单独编写集成。
为任务留出更多空间
智能体可以仅获取所需的操作详情和结果字段,并对较大的结果分页读取,从而避免把整个 API 目录载入对话。
执行前检查请求
MCP 服务器可以验证拟定的 API 请求,而不实际执行。验证会检查参数和适用的访问规则;真正执行操作时,仍会进行操作自身的检查。
确保连接能够到达应用
最简单的方式是在运行 MyMusik 的同一台电脑上运行智能体。远程智能体还需要有可到达运行中应用的网络路径。
- 如果要从局域网内的另一台设备连接,请检查“设置 → Web 服务器 → 允许远程访问”。更改连接设置后,请复制新的提示词。
- 运行在云端沙盒中的智能体无法自动访问你电脑的 localhost。请在本地运行智能体,或配置可到达的连接;复制的提示词中包含网络连接指引。
- 如果邀请已过期或已使用,请复制新的 AI 提示词。如果 MyMusik 已关闭或挂起,请重新打开后再试。
几个实用细节
AI 智能体能控制整个应用吗?
它可以使用 MyMusik 公开的各项应用功能,包括音乐库整理、标签、文件夹、播放列表、播放、导入、音频编辑和导出。可用操作取决于已安装的版本、平台和连接权限。智能体通过应用的 API 完成任务,无需逐个屏幕点击。
所有 Codex 或 Claude 环境都能使用吗?
智能体需要可用的 MCP 或 HTTP 工具、建立连接的权限,以及对应用的网络访问能力。仅把提示词粘贴到纯文字聊天中,无法建立连接。交付音乐任务前,请先让智能体验证访问情况。
可以使用标准 MCP 客户端吗?
可以。配对后,将客户端配置为运行 mymusik-mcp stdio。
这和 MyMusik 内置的 AI 语音功能一样吗?
此连接让你选择的外部智能体与 MyMusik 协作。应用内的 AI 语音功能有独立的设置。外部智能体的账户、模型和计费要求仍然适用;由 AI 驱动的应用操作也可能需要相应的服务访问权限。
音乐应用或智能体需要一直打开吗?
MyMusik 的原生服务器必须持续运行且可访问。退出或挂起应用会中断访问。会话有有效期,重新连接时可能需要新的邀请。断开连接不一定会取消已在应用中启动的任务。
智能体可以看到哪些信息?
它可以请求会话权限允许的应用数据。这些数据由你使用的智能体和模型提供方处理。“只读”会阻止写入,但仍允许读取数据。请按需选择范围更小的“自定义”权限,并妥善保管邀请和会话凭据。


