前言¶
寫譜、編曲或者做曲庫整理時,經常要做的一件事是找譜:找某個曲子的免費改編版、確認一份譜的授權能不能用、或者只看這份譜有多少頁。這些信息分散在 musescore.com 的頁面裏,手點一遍要開好幾個標籤頁,交給模型去做又得讓它自己抓網頁。
musescore-mcp 把這件事收斂成一次 MCP 調用:用自然語言問,Skill 負責搜索樂譜、返回結果並讀取指定譜的元數據。下面介紹它的定位、能力邊界和啓用條件。
這是什麼¶
一句話定位:一個面向 MuseScore 樂譜檢索與元數據讀取的 MCP Skill。
發佈信息如下,均來自 SkillHub 頁面:
- 名稱:musescore-mcp
- 座標:@user_15292d5a/yjkj-musescore-mcp
- 版本:1.0.0
- 來源:community
- 發佈者:user_15292d5a
- 分類:knowledge-management
- 標籤:requires_api_key=false
頁面顯示評分 100000,下載 875,安裝 0。requires_api_key=false 表示它不要求單獨申請 API Key,但前置依賴不止這一個,見「安裝與啓用」。
它解決的問題是:把「找譜 + 看譜信息」從手動翻頁面變成一條可被模型調用的工具,並且在授權、頁數這類細節上給出可覈對的返回值。
核心功能¶
官方簡介給出的能力是兩件事,下面分別說明。
1、搜索 MuseScore 樂譜¶
按曲名、改編類型等條件在 MuseScore 上找譜,返回候選列表。對應的觸發說法包括 “find sheet music for”、”search MuseScore for”、”is there a free arrangement of”。
2、讀取樂譜元數據¶
拿到指定譜之後讀它的元數據,典型字段是授權類型和頁數。對應的觸發說法包括 “what’s the license on this MuseScore score”、”how many pages is”。
觸發範圍¶
按官方簡介,任何涉及 MuseScore scores、arrangements 或 sheet-music metadata 的請求都會觸發這個 Skill。也就是說觸發面比前兩條示例更寬,不只是那幾個短語。
安裝與啓用¶
先說明一點:官方 Setup 段落指向 Skill 包內的說明,本次抓取 SkillHub 頁面和官方地址均未返回正文,因此下面的安裝命令、目錄路徑和配置字段沒有可覈對的來源,本文不寫推測值。需要落地時請到官方地址看 Setup 一節,再對照你所用的客戶端執行。
下面這段是官方簡介明確寫出的前置條件,屬於可覈對的事實:
1、musescore-mcp 已安裝。
2、fetchproxy 擴展處於活動狀態。
3、存在一個已登錄的 musescore.com 標籤頁。
三點缺一不可。第三條尤其關鍵:它不是走公開 API,而是借一個已登錄的瀏覽器標籤頁作爲抓取通道,所以 musescore.com 必須先登錄。
關於客戶端差異:Cursor、Codex CLI、Claude Code 各自的 Skill 加載方式不同,官方簡介只提到 “see Setup”,沒有給出分客戶端的說明,本文不分別展開。
典型用法¶
下面這些請求來自官方簡介列出的觸發短語,可以直接作爲驗證用例。
找譜:
find sheet music for [曲名]
在 MuseScore 上搜索:
search MuseScore for [曲名]
確認是否存在免費改編版:
is there a free arrangement of [曲名]
查授權:
what's the license on this MuseScore score
查頁數:
how many pages is [這份譜]
使用順序建議:先用前三條定位到具體譜,再拿譜的定位去問授權和頁數。經過上面的步驟,返回的元數據纔有對應的對象。
適用場景與注意¶
適合誰:需要在對話或自動化流程裏查 MuseScore 樂譜、並把授權與頁數作爲中間結果繼續處理的人,例如做曲庫整理、編曲前找參考譜、或者給模型加一個樂譜檢索入口。
限制與坑:
1、登錄態是硬前提。musescore.com 標籤頁未登錄時,搜索和讀元數據都不會返回可用結果,這是最容易踩的一條。
2、依賴 fetchproxy 擴展。擴展沒開,Skill 拿不到頁面內容。
3、它不做譜面編輯。能力是檢索與元數據讀取,不是生成音符或操作 MuseScore 工程文件。想找能改譜的 MCP 服務,需要另找項目。
4、頁面指標方面,下載 875、安裝 0,說明用的人還不多,遇到邊界情況可參考的信息有限。
5、官方地址本次無法抓取正文,動手之前先把 Setup 一節讀完,確認你所用客戶端的加載方式。
結尾¶
musescore-mcp 的價值在於把找譜和讀譜信息這兩件事從手動翻頁變成一次調用,代價是要準備好登錄態和 fetchproxy 擴展這層前置環境。如果你的工作流裏本來就需要頻繁查 MuseScore 的譜和授權信息,值得按官方 Setup 配一次。
官方地址:https://api.skillhub.cn/user_15292d5a/yjkj-musescore-mcp
SkillHub 頁面:https://www.skillhub.cn/skills/user_15292d5a/yjkj-musescore-mcp