musescore-mcp
musescore-mcp
MuseScore CLIをModel Context Protocol (MCP) サーバーとしてラップし、Claude AIから楽譜ファイルを直接変換・編集・分析できるようにするツールです。
目的
Claude AI (Claude Desktop, Claude Codeなど) でMuseScoreの楽譜ファイル(.mscz, .musicxml, MIDIなど)を自然言語コマンドで操作できるようにします。
提供機能:
カテゴリ | 機能 |
変換・エクスポート | PDF, PNG, MusicXML, MIDI, MP3などへの多様なフォーマット変換; パート別楽譜の抽出; 複数ページPNGのエクスポート |
編集 | 調の移調、音程の移調、楽器ごとの移調(移調楽器対応); 拍子の変更; テンポの変更 |
分析 | 楽譜の基本情報(タイトル・作曲家・拍子・調・小節数); 調号の変化リスト; 楽器編成および音域分析; 和声分析(ローマ数字表記) |
高度な機能 | MuseScoreスタイルファイル(.mss)の適用; QMLプラグインの実行; MusicXML文字列からの楽譜生成; MIDI → 楽譜変換; フォルダ監視による自動変換 |
要件
Python 3.10 以上
MuseScore 4 (または MuseScore 3) のインストール
Windows: musescore.org または Microsoft Store
インストール先が標準パスでない場合は、環境変数
MSCORE_PATHに実行ファイルのパスを指定してください
インストール
1. リポジトリのクローン
git clone https://github.com/strongbeen04/musescore-mcp.git
cd musescore-mcp2. 仮想環境の作成とパッケージのインストール
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate
# 기본 설치
pip install -e .
# 화성 분석 기능(music21) 포함 설치
pip install -e ".[harmony]"3. MCPサーバーの登録
Claude Desktop (Windows Store版)
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json ファイルに以下を追加します:
{
"mcpServers": {
"musescore": {
"command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
}
}
}Claude Desktop (通常インストール版)
%APPDATA%\Claude\claude_desktop_config.json ファイルに以下を追加します:
{
"mcpServers": {
"musescore": {
"command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
}
}
}Claude Code (CLI)
~/.claude.json ファイルに以下を追加します:
{
"mcpServers": {
"musescore": {
"type": "stdio",
"command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
}
}
}macOS / Linuxの場合は、command を .venv/bin/musescore-mcp に変更してください。
設定を保存した後、Claudeを再起動するとmusescoreサーバーが接続されます。
使用方法
Claudeとの会話中に楽譜ファイルを添付するか、パスを伝えてください。Claudeが内部的にMCPツールを呼び出します。
使用例:
"이 mscz 파일을 PDF로 변환해줘."
"악보를 Bb 클라리넷 기준으로 이조해줘."
"이 악보의 조성과 마디 수를 알려줘."
"MusicXML을 mscz 파일로 만들어줘."利用可能なMCPツール一覧
ツール | 説明 |
| MuseScore実行ファイルのパスを確認 |
| 単一ファイルのフォーマット変換 |
| 複数ファイルのバッチ変換 |
| パートごとの楽譜を個別に抽出 |
| 複数ページをPNGとしてエクスポート |
| 調を指定して移調 |
| 音程を指定して移調 |
| 移調楽器用に変換 |
| テンポ(BPM)の変更 |
| 拍子記号の変更 |
| 楽譜の基本情報を取得 |
| 調号の変化リストを取得 |
| 楽器編成および音域の確認 |
| タイトル・作曲家などのメタデータ修正 |
| 和声進行の分析 (music21が必要) |
| MuseScoreスタイル(.mss)の適用 |
| QMLプラグインの実行 |
| MusicXML文字列からmsczへ変換 |
| MIDIからmsczへ変換 |
| フォルダを監視して自動変換 |
目的
musescore-mcp は、MuseScore CLIをラップしたMCP (Model Context Protocol) サーバーであり、Claude AI (Claude Desktop, Claude Codeなど) が自然言語コマンドを通じて楽譜ファイルを変換、編集、分析できるようにします。
機能:
カテゴリ | 機能 |
変換・エクスポート | PDF, PNG, MusicXML, MIDI, MP3などへの変換; 各パートの抽出; 複数ページPNGのエクスポート |
編集 | 調や音程による移調; 楽器ごとの移調; テンポや拍子の変更 |
分析 | 楽譜メタデータ(タイトル、作曲家、調、拍子、小節数); 調号の変化; 楽器の音域; ローマ数字による和声分析 |
高度な機能 | MuseScoreスタイルファイル(.mss)の適用; QMLプラグインの実行; MusicXML文字列からの楽譜作成; MIDIから楽譜への変換; 監視フォルダ内の自動変換 |
要件
Python 3.10 以上
MuseScore 4 (または MuseScore 3) のインストール
Windows: musescore.org または Microsoft Store
標準以外のパスにインストールされている場合は、環境変数
MSCORE_PATHに実行ファイルのパスを設定してください
インストール
1. リポジトリのクローン
git clone https://github.com/strongbeen04/musescore-mcp.git
cd musescore-mcp2. 仮想環境の作成とインストール
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate
# Base install
pip install -e .
# With harmony analysis support (music21)
pip install -e ".[harmony]"3. MCPサーバーの登録
Claude Desktop (Windows Store)
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json を編集:
{
"mcpServers": {
"musescore": {
"command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
}
}
}Claude Desktop (標準インストール)
%APPDATA%\Claude\claude_desktop_config.json を編集:
{
"mcpServers": {
"musescore": {
"command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
}
}
}Claude Code (CLI)
~/.claude.json を編集:
{
"mcpServers": {
"musescore": {
"type": "stdio",
"command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
}
}
}macOS / Linuxでは、command を .venv/bin/musescore-mcp に変更してください。
設定を保存した後、Claudeを再起動してサーバーを接続してください。
使用方法
Claudeとの会話で楽譜ファイルを添付するか、パスを説明して自然言語で依頼してください。Claudeが自動的に適切なMCPツールを呼び出します。
例:
"Convert this mscz file to PDF."
"Transpose this score for Bb clarinet."
"What is the key and measure count of this score?"
"Create an mscz from this MusicXML."利用可能なMCPツール
ツール | 説明 |
| 検出されたMuseScore実行ファイルのパスを返す |
| 単一の楽譜を別のフォーマットに変換 |
| 一度の呼び出しで複数のファイルを変換 |
| 各楽器パートを個別のファイルとしてエクスポート |
| 全ページを個別のPNG画像としてエクスポート |
| 指定した調へ移調 |
| 指定した音程で移調 |
| 指定した楽器用に移調を書き換え |
| 新しいテンポ(BPM)を設定 |
| 拍子記号を変更 |
| タイトル、作曲家、調、拍子、テンポ、パート、小節数を返す |
| 小節番号ごとの調号の変化をリスト化 |
| 楽器名、移調、音域を返す |
| タイトル、作曲家、作詞家、著作権フィールドを編集 |
| コード進行を分析 (music21が必要) |
| MuseScoreスタイルファイル(.mss)を適用 |
| インストール済みのMuseScore QMLプラグインを実行 |
| MusicXML文字列からmsczを作成 |
| MIDIファイルをmsczに変換 |
| フォルダを監視し、新しい.msczファイルを自動変換 |
ライセンス
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude AI to generate professional, production-ready MIDI files (chord progressions, drum patterns, bass lines, melodies, and full arrangements) compatible with any DAW including Logic Pro, Ableton Live, FL Studio, and more.7MIT
- AlicenseNot gradedqualityDmaintenanceEnables natural language control over Ableton Live for generating musical patterns, melodies, and full song arrangements. It also provides tools for sample searching and mixing assistance through an OSC-based connection with Claude Desktop.1MIT
- FlicenseNot gradedqualityCmaintenanceEnables natural language control of Ableton Live through Claude, including session management, track and clip creation, device parameter adjustment, and browser browsing.1
- AlicenseNot gradedqualityDmaintenanceEnables semantic search of local audio samples by describing sounds, MIDI generation, stem separation, and other music production tools from Claude Desktop.1MIT
Related MCP Connectors
Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.
Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.
Connect Claude to Fathom meeting recordings, transcripts, and summaries
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/strongbeen04/MUSESCORE-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server