核心用法
musescore-mcp 是一个专为 MuseScore 乐谱平台设计的 MCP（Model Context Protocol）服务器，允许用户通过自然语言指令搜索和获取乐谱元数据。该工具通过独特的 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
显著优点
1. 无 API 依赖：MuseScore 已于 2024 年关闭公共消费者 API，此工具通过读取网页端同源数据实现功能
2. 隐私安全：不存储用户凭证，认证完全依赖浏览器会话，实现"零信任存储"架构
3. 格式全面：支持主流乐谱格式的元数据提取和下载链接解析
4. 开源可控：源码可审计，代理机制透明
潜在缺点与局限性
- 架构复杂：必须同时安装 MCP 服务器、fetchproxy 浏览器扩展，并保持 musescore.com 标签页登录状态
- 平台受限：仅支持桌面端浏览器环境，无法在无头服务器独立运行
- 下载间接：实际文件需用户手动在浏览器中打开链接获取，MCP 无法直接流式传输
- 稳定性风险：依赖第三方网站 DOM 结构，若 musescore.com 改版可能导致功能失效
- 授权边界：免费/付费内容判定完全遵循 MuseScore 平台规则，工具本身不提供破解
适合人群
- 音乐教育工作者需要批量检索教学用谱
- 古典音乐演奏者寻找公开领域乐谱
- 研究者分析乐谱元数据（调性、乐器编制、难度等）
- 需要将在线乐谱归档为本地 PDF 的收藏者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 服务依赖 | fetchproxy 扩展和浏览器会话必须持续可用 |
| 版权合规 | 需严格遵守 MuseScore 平台许可协议，PRO 内容需付费 |
| 技术债务 | 无官方 API 保障，维护依赖社区逆向工程 |
| 数据准确性 | 元数据来自用户上传，可能存在标注错误 |
---
版本状态: 早期开源项目，建议生产环境配合健康检查工具（musescore_healthcheck）定期验证连通性。