tuxguitar-claude-mcp
tuxguitar-claude-mcp
Claude でギター/ベースのタブ譜を書けるようにするMCPサーバーです。トラック、チューニング、小節、音符、そしてパームミュート、トレモロ・ピッキング、チョーキング、ハーモニクスなどのタブ譜エフェクタを、TuxGuitarで開ける .gp5 ファイルとして直接書き出します。
これはフェーズ1であり、ファイルベースのみです。実行中のTuxGuitarインスタンスをライブ制御する機能はありません(それ tは将来のフェーズ2として予定されており、まだ設計されていません)。
しくみ
MCPサーバー(TypeScript、@modelcontextuo/sdk)は、Claude がツール呼び出しごとに構築するインメモリの楽曲状態を保ホしル。トラックの作成、小節の追加、チューニングの設定、ビートと音符の挿入など行います。save_song は、その状態を小型の Java ヘルパー(song-writter/、TuxGuitar のライブラリ自体を使ってビルド)に渡し、実際の .gp5 ファイルにシリアライズします。
Related MCP server: musescore-mcp
必要条件
Windows かつ TuxGuitarがインストールされていること。サーバーは、そのインストールに同梡される JRE(
jre\bin\java.exe)および TuxGuitar 自身のライブラリにワーーアウトし、有効な.gp5ファイルを書きます。TuxGuitar 自体は実効されている必要はありません。デフォルトはC:\Program Files\tuxguitarです。別の場所にインストールしている場合は、T UXGUDITAR_HOME環境変数で上書きしてください。
Node.js(18+): MCP サーバー用。
Java 21 : Java ヘルパーを一度ビルドするために必要です(例: Eclipse Temurin JDK 21)。実行時には不要です。実行時は TuxGuitar に同梱された JRE が使用されます。
Claude Code(または他の MCP 互換クライアント)でサーバーを登録して使用します。
セットアップ
1. Java song-writer をビルドする
powershell -ExecutionPolicy Bypass -File song-writer\build.ps1任意で、テストを実行します:
powershell -ExecutionPolicy Bypass -File song-writer\test.ps12. MCP サーバーをビルドする
npm install
npm run build
npm run test3. Claude Code に登録する
mcpServers に追加します(グローバルでは ~/.claude.json、プロジェクトでは .mcp.json):
"tuxguitar": {
"type": "stdio",
"command": "node",
"args": ["<path-to-repo>\\dist\\index.js"],
"env": {}
}TuxGuitar が C:\Program Files\tuxguitar にインストールされていない場合は、env で TUXGUITAR_HOME を設定してください:
"env": { "TUXGUITAR_HOME": "D:\\Apps\\tuxguitar" }新しいサーバーを認識させるため、Claude Code を再起動してください。
ツール
ツール | 説明 |
| Java と song-writer ヘルパーが利用可可能であることを確認します。 |
| 新しく空の楽曲を開始します(現在の状態を破棄します)。 |
| 現在の楽曲のタイトル / アーチストを設定します。 |
| 現在の楽曲状態を JSON で返します。 |
| 現在の楽曲状態を |
| チューニングを持つ新しいトラック(ギター/ベース)を作成します。 |
| 現在の楽曲の全トラックを一覧表します。 |
| 既存トラックのチューニングを変更します。 |
| 楽曲の末尾に新しい小節を追加します(全トラックに適用)。 |
| 既存小節のテンポ(BPM)を設定します。 |
| 既存小節の拍子を設定します。 |
| 1つのトラックの小節に、順序付ビート(ノートを含むリズムスロット)のリストを挿入します。 |
| 指定した小節内の、1つのトラックのビートを全削除します。 |
手動統合テスト
tuxguitar_pingを呼び出し、"ok"が返ることを期待します。new_song、create_track、add_measure、add_beats、save_songを順に呼び出します。結 pow果の
.gp5ファイルを実際の TuxGuitar アプリで開き、視覚的/聴覚的に確認します。
既知の制限
フェーズ1のみ: 実行中の TuxGuitar インスタンスをライブ制御できません。
add_beatsは、ビートが小節の合計長に収まるかどうかを検証しません。超過してもエラーになりません。 *ビートのな小節は非整で、縵0は本当に空ですが、それ以イ後の小節には TuxGuitar の自動入された休符ビートが残ります。Windows のみ対応。
トラブルシューテング
"Unknown track_id" / "Unknown measure_index": 呼び出しの順序を確認してください。
add_beatsがそれらを参照する前に、トラックと小節が存在している必要があります。tuxguitar_pingが失敗した場合:song-writer\dist\tuxguitar-song-writer.jarが存在するか(build.ps1を再実行)を確認し、TUXGUITAR_HOME(またはデフォルトのC:\Program Files\tuxguitar)が実際の TuxGuitar インストールを指していルるか確認してください。
ライセンス
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
Turn Claude into a creative studio: DNA-locked characters, images, video, voiceover — 55 tools.
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
A film studio inside your own Claude: your Claude plans, writes, makes, checks and finishes films, pictures, voices and music with you, on your own provider keys.
Claude Code / MCP skills for the dev pipeline: discover, spec, design, build, ship, operate.
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.14MIT
- FlicenseAqualityDmaintenanceEnables Claude AI to convert, edit, and analyze MuseScore files (.mscz, .musicxml, MIDI) through natural language commands, supporting format conversion, transposition, harmony analysis, and more.201-
- AlicenseBqualityDmaintenanceEnables Claude to observe and compose in Ableton Live 12 via AbletonOSC, allowing pair-programming-style collaboration for musicians.13MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to compose real music from chord-symbol descriptions into MIDI files and audio previews, with musicology cross-checks on every chord.1AGPL 3.0