MIDI Files

🎵 MIDI ファイル MCP ツール

このツールは、Tone.js と @tonejs/midi ライブラリに基づいた MIDI ファイルの解析と操作を行う強力なツールです。MCP（モデルコンテキストプロトコル）サービスを通じて、MIDI ファイルの複雑な形式を深く理解することなく、簡単に読み取り、分析、および修正ができます。

🚀 クイックスタート

この MIDI ファイル MCP ツールを使用することで、AI アシスタントの支援を受けながら、MIDI ファイルを効率的に処理し、音楽制作やオーディオ処理の様々なニーズを満たすことができます。

✨ 主な機能

• MIDI ファイル情報の読み取り
• トラック、音符、コントロールチェンジ、ピッチベンド情報の取得と変更
• MIDI ファイルのテンポ（BPM）設定
• 特定のトラックに新しい音符、コントロールチェンジ、ピッチベンドの追加
• 新しいトラックの追加
• 完全なエラー処理

📦 インストール

前提条件

1. Node.js のインストール：npx コマンドが正常に動作するようにします。最新の安定版を Node.js 公式サイト からダウンロードすることをおすすめします。

💻 使用例

利用可能なクライアント

このツールは、以下のクライアントと連携して使用できます。

• Cursor
• Cherry Studio
• Claude Desktop

Cursor での MIDI ファイル MCP ツールの設定例

Cursor で midi-file-mcp を設定するには、以下のようにします。

"midi-file-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "midi-file-mcp"
    ]
}

絶対パスを使用した MIDI 解析器 MCP ツール

MIDI 解析器 MCP ツールのすべての操作には、MIDI ファイルの絶対パスが必要です。これにより、現在の作業ディレクトリに関係なく、ツールが正しく MIDI ファイルを見つけて操作できるようになります。

サンプルプロンプト

以下は、AI アシスタントと一緒に使用できるサンプルプロンプトです。

1. MIDI ファイル情報の取得：

   D:\path\to\your\file.mid の MIDI ファイルの情報を教えてください。
   

2. トラックの分析：

   D:\path\to\your\file.mid のすべてのトラックを分析し、各トラックに含まれる音符の数を教えてください。
   

3. テンポの設定：

   D:\path\to\your\file.mid のテンポを 120 BPM に設定してください。
   

4. 新しい音符の追加：

   D:\path\to\your\file.mid の最初のトラックに、チャンネル番号 1、ベロシティ 127 の MIDI 音符を追加してください。この音符は第 3 小節の始めから第 4 小節まで再生されるようにしてください。
   

パラメータ

各操作のパラメータは以下の通りです。

MIDI ファイル情報の取得

• コマンド：getMIDIFileInfo
• パラメータ：
  • filePath (必須)：情報を取得する MIDI ファイルのパス。

トラック情報の取得

• コマンド：getTrackInfo
• パラメータ：
  • filePath (必須)：トラック情報を取得する MIDI ファイルのパス。
  • trackIndex (オプション)：取得する特定のトラックのインデックス（0 から始まる）。

テンポの設定

• コマンド：setTempo
• パラメータ：
  • filePath (必須)：テンポを設定する MIDI ファイルのパス。
  • tempoBPM (必須)：新しい BPM 値（毎分の拍数）。

新しい音符の追加

• コマンド：addNote
• パラメータ：
  • filePath (必須)：音符を追加する MIDI ファイルのパス。
  • channel (必須)：音符が属するチャンネル番号（1 から始まる）。
  • noteNumber (必須)：MIDI 音符番号（例：60 は C4）。
  • velocity (オプション、デフォルトは 127)：音符のベロシティ値（0 から 127）。
  • startTime (オプション、デフォルトは現在の時間)：音符の再生開始時間（MIDI 時間単位）。

すべての音符の取得

• コマンド：getNotes
• パラメータ：
  • filePath (必須)：音符を取得する MIDI ファイルのパス。
  • channel (オプション)：フィルタリングするチャンネル番号（1 から始まる）。指定しない場合は、すべてのチャンネルの音符が返されます。

トラックの削除

• コマンド：removeTrack
• パラメータ：
  • filePath (必須)：トラックを削除する MIDI ファイルのパス。
  • trackIndex (必須)：削除する特定のトラックのインデックス（0 から始まる）。

新しいトラックの追加

• コマンド：addTrack
• パラメータ：
  • filePath (必須)：トラックを追加する MIDI ファイルのパス。

📚 ドキュメント

何か問題がある場合や、さらなる支援が必要な場合は、サポートチーム にお問い合わせください。