核心功能
musescore-mcp 是一个专为 MuseScore 乐谱网站设计的 MCP 服务器，提供曲谱搜索、元数据读取和下载链接解析能力。由于 MuseScore 官方并未开放公共 API，该工具采用创新的浏览器代理方案：通过 fetchproxy 扩展将请求路由至用户已登录的浏览器标签页，从而绕过 Cloudflare 检测获取服务器渲染数据。
主要工具能力
- musescore_search: 搜索曲谱，默认筛选免费可查看/播放/下载的资源，支持完整的筛选参数
- musescore_get_score: 获取单首曲谱详细元数据（标题、许可证、调号、声部、时长等）
- musescore_download: 解析官方下载链接（PDF/MIDI/MuseScore 格式/MusicXML），适用于免费或已购曲谱
- musescore_score_to_pdf: 智能 PDF 生成——优先获取官方 PDF，无官方版本时自动抓取 SVG 页面并合并
- musescore_svg_to_pdf: 本地 SVG/SVGZ 文件批量转 PDF
显著优点
1. 零凭证存储: 身份认证完全依托浏览器会话，无需在 MCP 服务器中保存账号密码
2. 智能降级: PDF 导出功能具备官方链接/SVG 渲染双通道，确保最大可用性
3. 合规筛选: 默认启用 "Free to view, play & download" 筛选，降低版权风险
潜在局限与风险
| 类别 | 说明 |
|------|------|
| **架构依赖** | 必须同时运行 fetchproxy 浏览器扩展并保持 musescore.com 登录状态，使用门槛较高 |
| **技术脆弱性** | 依赖非公开 API 的数据结构， MuseScore 前端更新可能导致解析失效 |
| **版权边界** | 付费曲谱下载需 PRO 订阅或单独购买，工具仅提供链接解析不绕过付费墙 |
| **文件传输** | 实际文件下载需用户手动在浏览器中打开链接，MCP 无法直接流传输 |
| **平台限制** | SVG 转 PDF 依赖本地 `rsvg-convert` 工具，Windows 用户需额外配置 |
适用人群
- 音乐教育从业者需要批量整理教学曲谱
- 古典音乐研究者追踪作品版本与授权信息
- 编曲者参考现有公开域作品进行二次创作
- 合唱团/乐团管理员整理演出曲目资料库
常规风险提示
- 曲谱搜索结果中的
publicDomain标记需人工复核，不同国家/地区公共领域期限存在差异 - 频繁请求可能触发 MuseScore 反爬机制，建议配合合理速率控制
- fetchproxy 的 WebSocket 连接存在单点故障风险，长期使用建议监控
musescore_healthcheck状态