核心用法
musescore-mcp 是一个面向 MuseScore 平台的 MCP（Model Context Protocol）服务器，允许 AI 助手通过标准化接口搜索乐谱、读取元数据并处理下载。其关键特性在于通过 fetchproxy 浏览器扩展 将请求路由至用户已登录的 musescore.com 标签页，从而绕过 Cloudflare 对自动化流量的拦截。
功能概览
| 工具 | 用途 |
|------|------|
| `musescore_search` | 搜索乐谱，默认可免费查看/下载，支持筛选完整目录 |
| `musescore_get_score` | 获取单条乐谱元数据（标题、授权、调性、声部、时长等） |
| `musescore_download` | 解析官方下载链接（PDF/MIDI/MSCZ/MusicXML） |
| `musescore_score_to_pdf` | 生成 PDF（优先官方链接，否则拼接 SVG） |
| `musescore_svg_to_pdf` | 本地 SVG 转 PDF |
| `musescore_healthcheck` | 验证 fetchproxy 桥接状态 |
显著优点
1. 无 API 依赖：绕过 MuseScore 已关闭的公开 API，直接读取服务端渲染数据
2. 隐私安全：不存储用户凭证，认证状态完全托管于用户自己的浏览器会话
3. 格式完整：支持 MuseScore 原生格式（.mscz）及标准交换格式（MusicXML、PDF、MIDI）
4. 开源可控：服务端代码公开（GitHub），可审计
潜在缺点与局限性
- 架构复杂：必须同时安装 Node 服务端 和 浏览器扩展，并手动保持 musescore.com 登录状态
- 无法直接下载：因 Cloudflare + S3 跨域限制，MCP 只能返回下载链接，需用户手动在浏览器中打开
- SVG 拼接质量：官方 PDF 不可用时，依赖 rsvg-convert 拼接 SVG，复杂排版可能出现瑕疵
- 仅限已授权资源：付费/PRO 内容需用户账户具备相应权限，免费资源才可直接访问
- 单点故障：fetchproxy 扩展或浏览器标签页异常会导致服务中断
适合人群
- 音乐研究者、编曲者需要批量检索乐谱元数据
- 教育场景下需要获取公有领域（public domain）乐谱
- 已拥有 MuseScore PRO 订阅，希望通过 AI 辅助管理个人曲库的用户
- 能够接受浏览器扩展方案的技术用户
常规风险
| 风险类别 | 说明 |
|---------|------|
| 服务稳定性 | 依赖第三方网站结构，MuseScore 前端改版可能导致解析失效 |
| 授权合规 | 仅应访问账户已授权的资源，避免绕过付费机制 |
| 隐私边界 | fetchproxy 扩展需足够权限与浏览器通信，建议审查扩展代码 |
| 本地命令执行 | `rsvg-convert` 调用涉及本地 shell 命令，需确保输入参数可信 |