sd80
Enables control of MIDI hardware, specifically the Roland SD-80 synthesizer, including instrument and bank selection, channel mixing, SysEx/mode switching, note and drum pattern playback, and multi-track song scheduling.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
SD-80 Control API
Roland SD-80 (Studio Canvas) をLLMから演奏・制御するための MCPサーバー + REST API + Claude Skill です。LLMは音色を「何の楽器か」で検索し、テキスト記法で書いた曲を そのまま実機で鳴らせます。Bank Select / Program Change / SysEx の組み立て、発音の スケジューリングはすべてサーバー側が行います。
非公式プロジェクトです。Roland Corporation とは関係がなく、同社による承認・保証は ありません。Roland、EDIROL、Studio Canvas、SD-80 は Roland Corporation の商標です。
LLM ─┬─ MCP (Streamable HTTP /mcp) ─┐
├─ Skill スクリプト (REST) ────┼─> ツール層 ──> コントローラ ──MIDI──> Roland SD-80
└─ REST POST /tools/{name} ───┘ ├ 音色辞書 1,280音色 + ドラム36セット(楽器名・タグ・音域つき)
├ ジャンル別編成 30種 / 聴き比べ / 評価の記憶
└ テキスト記法 → 検算 → 高精度スケジューラ必要なもの
Roland SD-80(SD-90 でも同じ音色マップのため動く見込みですが未確認)
SD-80 を USB でつないだ PC。動作確認は Windows 11 のみです (Windows 10 / 11 では本体を GENERIC モードで使います → docs/SD80_DRIVER_SETUP.md)
Python 3.10 以上
Related MCP server: CHUK Music MCP Server
セットアップ
py -m pip install -r requirements.txt
:: MIDIポートとSD-80自動検出の確認
py -m sd80ctl ports
:: 実機テスト(音が出ます)。SD-80が見つからない場合は --port-index N を指定
py -m sd80ctl selftest
:: サーバ起動 (http://127.0.0.1:8760 , Swagger UI は /docs)
start_server.batmacOS / Linux では py を python3 に読み替えてください(未検証)。
サーバーは起動時に SD-80 のポートを自動検出し、Native mode で初期化します。
別の PC から使う場合は docs/REMOTE_SETUP.md を参照してください。
使い方(3通り、中身は同じツール)
1. MCP
/mcp で Streamable HTTP(stateless)のMCPサーバーを公開しています。Claude Code で
このリポジトリを開くと、同梱の .mcp.json により sd80 サーバーに
接続されます(先にサーバーを起動しておく)。他のクライアントの設定例:
{ "mcpServers": { "sd80": { "type": "http", "url": "http://127.0.0.1:8760/mcp" } } }2. Claude Skill
.claude/skills/sd80/ に、音色選び・記法・編曲の手順書と クライアントスクリプトを収めたSkillがあります。Claude Code でこのリポジトリを開けば 自動で認識されます。MCPを設定していない環境でも、Skill同梱のスクリプトが同じツールを REST経由で呼び出します。
:: 他のプロジェクトからも使えるようにユーザー全体(~/.claude/skills/sd80)へインストール
py -m sd80ctl install-skillpython .claude/skills/sd80/scripts/sd80.py health
python .claude/skills/sd80/scripts/sd80.py search_instruments query="tenor sax" role=solo
python .claude/skills/sd80/scripts/sd80.py play_song @.claude/skills/sd80/assets/jazz-trio-demo.json3. REST
POST /tools/{name} にMCPと同じJSON引数を送ります(GET /tools で一覧とスキーマ)。
py -m sd80ctl call <tool> key=value ... でも呼べます。
curl -X POST http://127.0.0.1:8760/tools/suggest_palette -H "Content-Type: application/json" -d "{\"style\":\"jazz\"}"チャンネル単位の細かいエンドポイント(/channels/{ch}/note_on、/midi/sysex など)も
スクリプト用に残してあります。一覧は GET / または /docs。
ツール(19本)
分類 | ツール | 役割 |
状態 |
| 接続・モード・再生位置・使用中チャンネル・評価済み音色・保存済みの曲 |
| 接続 + モード切替 + 全パートを既知の状態に戻す | |
音色 |
| 楽器名・性格・機材名・日本語で検索。 |
| 概要、または系統ごとの一覧表(4セット横並び) | |
| 1音色の詳細: 正体・音域・書き方のコツ・代替候補・ドラムのキー表 | |
| ジャンル別の編成一式(30種): チャンネル・音色・ミックス値・代替 | |
| 候補を順番に鳴らして聴き比べ | |
| 聴いた人の評価を保存(検索順位に反映) | |
チャンネル |
| 音色とミックス(volume / pan / reverb / chorus) |
| 任意のControl Change | |
演奏 |
| 1チャンネルにフレーズやドラムパターンを即再生 |
| マルチトラックの曲を検算して保存・再生。 | |
| 保存済みの曲の一覧・取得・MIDIファイル書き出し | |
| 全停止 | |
接続 |
| 自動検出できないときの手動接続 |
説明書 |
| Skillと同じ手順書(overview / tones / notation / arranging / troubleshooting) |
結果は1行1項目のコンパクトなJSONで返り、失敗時は直し方を含むメッセージを返します。
MIDIポート未接続のときは warning: NOT CONNECTED が必ず付きます。
記法
C4:1 E4:0.5 G4:0.5 | C4+E4+G4:2 R:2 音名:拍数 / + 和音 / R 休符 / | 小節線(拍数を検算)
C4:1@110 C4:2~ | C4:2 [C2:1 G2:1]*4 ベロシティ / タイ / 繰り返し
ped=on expr=40>110:4 bend=1.5 ペダル / クレッシェンド / ピッチベンド
{"kick":"x...x...x...x...","snare":"....x.......x..."} ドラムグリッド(1文字=16分)曲は tracks(チャンネル・音色・ミックス)と sections(セクションごとの各パート。短い
パートは自動で繰り返す)、arrangement(並び順)で書きます。全文法は
references/notation.md、動く例は
assets/jazz-trio-demo.json。
play_song は鳴らす前に全体を検算し、小節の拍数違い・楽器の音域外・MFX音色の置き場所
違いを warnings で返します。曲は data/songs/ に保存され、次のセッションでも
song_id で再生・編集できます。
セキュリティ
このサーバーは接続した相手に SD-80 を操作させ、任意の SysEx も送れます。
既定(
start_server.bat)は127.0.0.1だけで待ち受け、localhost宛ての要求にしか 応答しません(Webページからの DNS リバインディング対策)。ブラウザからの CORS も既定で 無効です(必要ならSD80_CORS_ORIGINSに許可するオリジンをカンマ区切りで指定)。ネットワークに公開する(
--host 0.0.0.0、start_server_tailscale.bat)には共有トークンSD80_MCP_TOKENが必須です。設定すると/health以外のすべてのエンドポイントでAuthorization: Bearer <token>が必要になります。トークンなしで別のホスト名を許可したい場合は
SD80_ALLOWED_HOSTS(カンマ区切り)。インターネットに直接公開しないでください。Tailscale などのプライベートネットワークか 信頼できる LAN の中で使ってください。
音色辞書
同梱の data/instruments.json は、Roland が配布していた SD-80 / SD-90 の公式音色リスト
(SD_inst.txt / SD_drum.txt / SD_wave.txt)と Cakewalk 用の純正インストゥルメント
定義(SD-80.ins)から生成したものです。これらの元ファイルは Roland の著作物のため
このリポジトリには含めていません。そのままで使えるので、通常は元ファイルは不要です。
4マップ(Classical / Contemporary / Solo / Enhanced, MSB 96-99)× PC 1-128 × バリエーション(LSB)、Special 1/2(MSB 80/81)、ドラムセット 4マップ(MSB 104-107)
instrument_idは{マップ}-{PC 3桁}-{LSB 2桁}(例:sol-001-00= Solo の St.Piano 1)
公式リストの名前は12文字の略称なので、sd80ctl/tonemeta.py が各音色に次を付与します:
項目 | 内容 | 出どころ |
| 実際の楽器(例: | 純正Cakewalk定義のGM2名を4マップ全部に展開 |
| 16系統。公式では無分類の Special 1/2 も分類 | Special 256音色は手作業で分類(うち41は名前からの推測で |
| stereo / rotary / jupiter / wurlitzer / distortion … | 名前の略号を規則で解読 |
| 典型的な音域 | 楽器ごとの一般的な音域 |
| マルチエフェクト前提の音色か | Enhanced / Special |
tonemeta.py を変更したときは辞書を作り直します。元ファイルを各自で用意し、
SD80_INSTLIST/(3ファイル)と cw_ins/CW_SD80/SD-80.ins に置いてから:
py -m sd80ctl build-dbMFXについて
オーナーズマニュアルによると、Native modeでは Enhanced / Special の音色を選んだだけでは
エフェクト(MFX、3系統)は掛からず、出荷時設定でMFXに接続されているのはパート A01〜A03
だけです。そのためサーバーは、MFX音色がチャンネル1〜3以外に置かれると警告し、
同じ楽器の Contemporary / Solo 音色を提案します。suggest_palette の編成もこの配置に
従っています。本体パネルでパートのMFX割り当てを変えた場合は、この警告は当てはまりません。
評価の記憶
rate_instrument の内容は data/user_tone_notes.json に保存され、検索結果の表示と順位
(お気に入りは先頭、「避ける」は末尾)に反映されます。LLMは音を聴けないので、
audition_instruments で候補を聴き比べ → 評価を保存、という流れで選択が改善していきます。
制限事項
実機での動作確認は Windows 11 + SD-80 1台のみです。SD-90、macOS / Linux は未確認です。
音色の説明・ジャンル別編成・推奨音色は、名前とサウンドセットの性格から選んだもので、 すべてを耳で確かめたわけではありません。
guess: trueの音色は特に要確認です。本体の設定(MFX の割り当て、パートの受信チャンネルなど)を出荷時から変えていると、 警告や推奨が実際と合わない場合があります。
GM2 / GS / XG モードでは Special セットが使えず、
instrument_idによる音色選択は Native mode 前提です。
トラブルシューティング
SD-80がポート一覧に出ない — 本体を GENERIC モードで起動します (docs/SD80_DRIVER_SETUP.md)。5pin MIDI 経由の場合は
POST /midi/probeで応答ポートを特定しopen_midi_portで開いてください。warning: NOT CONNECTED— MIDIポート未接続です。sd80_initで再接続します。Enhanced/Special音色が薄い — 上記「MFXについて」を参照。チャンネル1〜3に置きます。
403 forbidden host— トークンなしのサーバーに別のホスト名で接続しています。127.0.0.1で接続するか、SD80_MCP_TOKENを設定してください。
構成
sd80ctl/
parser.py 公式音色リスト → data/instruments.json 変換
insfile.py Cakewalk 定義ファイル(.ins)の読み込みと突合
tonemeta.py 音色メタデータ(正体・分類・タグ・音域・MFX)、サウンドセットの説明
dictionary.py 音色辞書のロード、検索(日本語可)、ドラム名の解決、評価の保存
palettes.py ジャンル別編成 30種
notation.py テキスト記法のパーサ(音符・コントローラ・ドラムグリッド)
song.py ソングのモデル、コンパイルと検算、MIDIファイル書き出し、保存
midi.py python-rtmidi ラッパ(自動検出・Identityプローブ・A/Bグループ)
sysex.py モード切替SysEx・DT1(checksum自動計算)
controller.py パート状態、音色変更、スケジューラ、聴き比べ
tools.py LLM向けツール層(MCP / REST / Skill 共通)
mcp_server.py MCPサーバー (Streamable HTTP)
server.py FastAPI アプリ (REST + /mcp、アクセス制御)
runtime.py 共有シングルトン
cli.py build-db / ports / selftest / serve / call / install-skill
.claude/skills/sd80/ Claude Skill(SKILL.md, references/, scripts/sd80.py, assets/)
tests/ 単体テスト(偽のMIDIポートを使用、実機不要)
docs/ Windows での認識方法、別PCからの利用、API利用ガイド
data/instruments.json 音色辞書(生成済み)実行中に data/songs/(保存した曲)、data/user_tone_notes.json(評価)が作られます
(.gitignore 済み)。
テスト
py -m unittest discover -s tests -t tests実機には触れず、偽のMIDIポートに対して送信内容とタイミングを検証します。
ライセンス
MIT License。対象はこのリポジトリのコードとドキュメントです。
data/instruments.json に含まれる音色名・ドラム音名・バンク番号は Roland の公式資料に
由来する情報で、その権利は Roland Corporation に帰属します。MIT License はこれらの
名称自体には及びません。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Browser DAW for AI assistants: build multitrack songs with MIDI, effects, stems and generation.
Synth, sampler and music tracker for AI assistants: sound effects, UI sounds and songs as audio.
Autonomous music production for AI agents with MIDI generation, QC and provenance.
Score video, make music as an agent: 100+ AI instruments play your MIDI, audio, stems, Logic/Ableton
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables LLMs to compose and play multi-track MIDI music through natural language prompts. Supports outputting to software or hardware synthesizers for enhanced audio quality.225MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-assisted music composition through copyable pattern templates, style constraints, and arrangement tools that compile to MIDI files. Provides 30+ tools for managing musical structures, layers, patterns, and styles with deterministic compilation from YAML arrangements.1MIT
- AlicenseBqualityDmaintenanceEnables LLMs to compose music by describing musical intent using high-level operations like notes, chords, dynamics, and tempo, then renders the composition into standard MIDI files.47MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-assisted MIDI music generation and composition through natural language, supporting style, tempo, key, and instrument selection.MIT