Skip to main content
Glama

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-mcp

2. 仮想環境の作成とパッケージのインストール

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ツール一覧

ツール

説明

get_musescore_path

MuseScore実行ファイルのパスを確認

convert_score

単一ファイルのフォーマット変換

batch_convert

複数ファイルのバッチ変換

export_parts

パートごとの楽譜を個別に抽出

export_png_pages

複数ページをPNGとしてエクスポート

transpose_by_key

調を指定して移調

transpose_by_interval

音程を指定して移調

transpose_for_instrument

移調楽器用に変換

change_tempo

テンポ(BPM)の変更

change_time_signature

拍子記号の変更

get_score_info

楽譜の基本情報を取得

get_key_signature

調号の変化リストを取得

list_instruments

楽器編成および音域の確認

update_metadata

タイトル・作曲家などのメタデータ修正

analyze_harmony

和声進行の分析 (music21が必要)

apply_style

MuseScoreスタイル(.mss)の適用

run_plugin

QMLプラグインの実行

create_from_musicxml

MusicXML文字列からmsczへ変換

midi_to_score

MIDIからmsczへ変換

watch_folder

フォルダを監視して自動変換


目的

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-mcp

2. 仮想環境の作成とインストール

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ツール

ツール

説明

get_musescore_path

検出されたMuseScore実行ファイルのパスを返す

convert_score

単一の楽譜を別のフォーマットに変換

batch_convert

一度の呼び出しで複数のファイルを変換

export_parts

各楽器パートを個別のファイルとしてエクスポート

export_png_pages

全ページを個別のPNG画像としてエクスポート

transpose_by_key

指定した調へ移調

transpose_by_interval

指定した音程で移調

transpose_for_instrument

指定した楽器用に移調を書き換え

change_tempo

新しいテンポ(BPM)を設定

change_time_signature

拍子記号を変更

get_score_info

タイトル、作曲家、調、拍子、テンポ、パート、小節数を返す

get_key_signature

小節番号ごとの調号の変化をリスト化

list_instruments

楽器名、移調、音域を返す

update_metadata

タイトル、作曲家、作詞家、著作権フィールドを編集

analyze_harmony

コード進行を分析 (music21が必要)

apply_style

MuseScoreスタイルファイル(.mss)を適用

run_plugin

インストール済みのMuseScore QMLプラグインを実行

create_from_musicxml

MusicXML文字列からmsczを作成

midi_to_score

MIDIファイルをmsczに変換

watch_folder

フォルダを監視し、新しい.msczファイルを自動変換


ライセンス

MIT

Install Server
F
license - not found
A
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables 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.
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables semantic search of local audio samples by describing sounds, MIDI generation, stem separation, and other music production tools from Claude Desktop.
    1
    MIT

View all related MCP servers

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

View all MCP Connectors

Latest Blog Posts

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