核心用法
musescore-mcp 是一个针对 MuseScore 乐谱平台的 MCP（Model Context Protocol）服务，主要功能包括：
- 搜索乐谱：
musescore_search工具可按标题、作曲家、乐器等条件检索，默认筛选"免费查看、播放和下载"的乐谱，也可搜索完整目录。 - 获取元数据：
musescore_get_score提取单首乐谱的详细信息，包括许可证类型、页数、调性、声部、时长等版权与结构数据。 - 下载支持：
musescore_download解析官方下载链接（PDF/MID/MSCZ/MXL），musescore_score_to_pdf可将乐谱转为PDF（优先官方链接，否则拼接SVG）。
关键机制：MuseScore 无公开消费级 API（旧版已关闭），本服务通过 fetchproxy 浏览器扩展，利用用户已登录的 musescore.com 标签页会话发起请求，使 Cloudflare 将其识别为真实浏览器而非自动化脚本。
显著优点
1. 绕过反爬机制：借助真实浏览器会话，有效应对 Cloudflare 验证，无需处理复杂的验证码或 IP 封禁。
2. 无需存储凭据：认证状态完全依赖浏览器标签页，MCP 服务端不保存用户名密码，降低凭证泄露风险。
3. 格式兼容性强：支持官方原生格式与 SVG 渲染回退方案，覆盖绝大多数乐谱的下载需求。
4. 元数据完整：返回许可证状态（publicDomain/免费/需购买）、难度等级、乐器配置等结构化信息，便于版权合规判断。
潜在缺点与局限性
- 依赖浏览器常驻：fetchproxy 扩展和登录状态的标签页必须持续运行，断线或会话过期会导致服务中断。
- 仅只读访问：无法上传、编辑或交互式演奏乐谱，功能局限于搜索与下载。
- 下载需人工介入：由于跨域 S3 重定向限制，MCP 只能返回下载链接，用户需手动在浏览器中打开完成下载。
- SVG 转换依赖本地工具：
rsvg-convert需预先安装，Windows 环境配置门槛较高。 - 法律灰色地带：通过非官方 API 抓取数据可能违反 MuseScore 服务条款，存在账号封禁风险。
适合人群
- 音乐研究者与教育工作者：需要批量获取公有领域或开放授权乐谱的元数据与文件。
- 业余演奏者：快速查找特定曲目（如钢琴改编版）的免费资源。
- 图书馆与档案馆：对乐谱进行编目整理，核验版权状态（public domain / Creative Commons）。
常规风险
- 账号安全：共享浏览器会话若被恶意脚本利用，可能导致 MuseScore 账号异常活动或封禁。
- 数据一致性：依赖服务器渲染的 HTML 结构，MuseScore 前端更新可能导致解析失效。
- 版权合规：误下载受版权保护的商业乐谱可能引发法律纠纷，需严格核对
free、publicDomain、license字段。 - 供应链风险：fetchproxy 扩展与 MCP 服务器均需从私有仓库或第三方渠道安装，存在代码篡改可能。