MCP Koii

🚀 Teenage Engineering EP-133 K.O. IIのMCPインターフェース

このプロジェクトは、MIDIを介してTeenage EngineeringのEP-133 K.O. IIサンプラーを制御するためのモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• MIDIを介してEP-133 K.O. IIデバイスに接続する
• テキストコマンドを使用して音符とパターンを再生する
• サウンドマッピングを理解するためにデフォルトのパッド設定を表示する
• シンプルなテキストベースの構文を使用してドラムパターンを作成し再生する
• 複数の楽器参照方法（パッドラベル、MIDI音高、楽器名、サウンド名）をサポートする
• 複数の楽器のドラムパターンを同時に再生する
• MCPを介してClaudeと統合する

📦 インストール

前提条件

• Python 3.8以上
• mido（MIDI処理）
• mcp（モデルコンテキストプロトコルSDK）

クイックインストール

# 必要なパッケージをインストールする
pip install mido "mcp[cli]"

# リポジトリをクローンする
git clone https://github.com/benjaminr/mcp-koii.git
cd mcp-koii

# MCPサーバーをインストールする
mcp install koii_server.py:server -e .

💻 使用例

Claude Desktopとの連携

1. EP-133 K.O. IIをUSBでコンピューターに接続してください。
2. MCPをサポートするClaude Desktopを起動します。
3. Claudeに自然言語の質問を投げかけることでEP-133 K.O. IIを制御できます。
   • "利用可能なMIDIポートを一覧表示する"
   • "EP-133デバイスに接続する"
   • "Cメジャースケールを再生する"
   • "ベースを1拍目と3拍目、シンバルを2拍目と4拍目、ハイハットを8分音符ごとに再生するドラムパターンを再生する"

開発モードでの実行

Claude Desktopを使用せずにMCPサーバーを開発モードで実行してテストすることができます。

# チェッカーUI付きで実行する
mcp dev koii_server.py:server -e .

📚 ドキュメント

基本コマンド

• 利用可能なMIDIポートを一覧表示する：システム上のすべての利用可能なMIDI出力ポートを表示します。
• MIDIデバイスに接続する：名前またはポート番号でEP-133 K.O. IIに接続します。
• 切断する：現在接続されているEP-133 K.O. IIから切断します。

音楽再生

• BPMを設定する：指定された拍数で再生速度を設定します。
• スケールを再生する：指定されたMIDI音高のリストを順番に再生します。
• パターンを再生する：ドラムパターンをループ再生します。

🔧 注意事項

• EP-133 K.O. IIが正しいMIDIモードに設定されていることを確認してください。
• 未知の楽器をテストする場合は、正確なサウンド名、パッドラベル、MIDI音高、またはサウンド名を使用してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。

謝辞

• Teenage Engineering がEP-133 K.O. IIを提供してくれました。
• Anthropic がClaudeとモデルコンテキストプロトコルを提供してくれました。
• MIDO がMIDI処理ライブラリを提供してくれました。