Ableton MCP Extended

ClaudeやCursorのようなAIアシスタントを介して、自然言語でAbleton Liveを制御します。このプロジェクトは、自然言語コマンドをAbleton Liveセッション内の正確なアクションに変換する、堅牢なModel Context Protocol (MCP) サーバーを提供します。

ビデオデモ: https://www.youtube.com/watch?v=7ZKPIrJuuKk

このツールは、音楽制作のワークフローを効率化し、生成音楽を実験し、Ableton Liveとのカスタム統合を構築したいプロデューサー、開発者、AI愛好家のために設計されています。

このような会話を変換できます：

👤 "Create a brief minimalist/neo-classical composition in a style similar to Ólafur Arnalds'. (Ableton MCP) / I've loaded four MIDI tracks called "Noire" and "Noire (2) ["Emotional Felt" presets], "Noire (2) ["Reversed Felt" preset, for ambient background], and "Noire (3) ["Ethereal Felt" preset, also for ambient background]. All loaded with nice piano instruments. You have also a MIDI track called "Strings" with a nice string ensemble instrument loaded. Feel free to add new instruments and effects, if pertinent."
🤖 "Creating MIDI clips... Adding effects... Done!"
👤 "Then, use ElevenLabs MCP to create a spoken-word audio clip (default voice and settings) with a relevant poem in the style of “Jim Morrison” to accompany the composition."  
🤖 "Generating poem... Transforming it into speech... Importing it into your session... Done!"

このような音楽制作セッションへ：

https://github.com/user-attachments/assets/d6ef2de5-bdeb-4097-acc0-67d70f7f85b3

主な機能

このプロジェクトは、Ableton Live環境に対する包括的かつプログラム可能な制御を提供します。

• セッションおよびトランスポート制御:

  • 再生の開始と停止。

  • テンポ、拍子、トラック数を含むセッション情報の取得。

  • シーンの管理：作成、削除、名前変更、実行。

• トラック管理:

  • MIDIトラックおよびオーディオトラックの作成、名前変更、詳細情報の取得。

  • トラックプロパティの制御：ボリューム、パン、ミュート、ソロ、アーム。

  • トラックのグループ化と折りたたみ状態の管理。

• MIDIクリップとノートの操作:

  • 指定した長さのMIDIクリップの作成と名前付け。

  • クリップ内のノートの追加、削除、移調、クオンタイズ。

  • 単一操作での複数ノートに対するバッチ編集。

  • クリップのループパラメーターとフォローアクションの調整。

• デバイスとパラメーターの制御:

  • URIを使用してAbletonのブラウザからインストゥルメントやエフェクトをロード。

  • トラック上の任意のデバイスのパラメーターリスト全体を取得。

  • 正規化された値（0.0〜1.0）を使用して、デバイスパラメーターを設定および一括設定。

• オートメーションとエンベロープ:

  • クリップ内の任意のデバイスパラメーターに対してオートメーションポイントを追加およびクリア。 [この機能はまだ完全には動作していません。]

  • 既存のクリップエンベロープに関する情報の取得。

• ブラウザ統合:

  • Abletonのブラウザ内のアイテムをナビゲートおよびリスト表示。

  • ブラウザのパスまたはURIから直接インストゥルメント、エフェクト、サンプルをロード。

  • オーディオファイルをオーディオトラックやクリップスロットに直接インポート。

• 音声・オーディオ生成

  • テキスト読み上げ統合：ElevenLabs MCP [同梱] を通じて、ナレーション、ボーカルサンプル、または音声要素を生成。

  • カスタム音声作成：トラックに独自のキャラクターを持たせるための音声クローン。

  • サウンドエフェクト：AIでカスタムSFXを作成。

  • 直接インポート：生成されたオーディオがAbletonセッションに即座に表示されます。

• カスタムツール用の拡張可能なフレームワーク

  • 例：XYマウスコントローラー：MCPフレームワークを使用してカスタムAbletonコントローラーを作成する方法を実演。

  • 超低遅延：高性能なUDPプロトコルにより、応答性の高いリアルタイム制御を実現。

  • 無限の可能性：Ableton Live用の独自のカスタムツールやコントローラーを構築可能。

クイックスタート (5分)

前提条件

• Ableton Live 11+ (任意のエディション)

• Python 3.10以上

• Claude Desktop または Cursor IDE

1. コードの取得

git clone https://github.com/uisato/ableton-mcp-extended.git
cd ableton-mcp-extended
pip install -e .

2. Abletonスクリプトのインストール

1. AbletonのRemote Scriptsフォルダーを探します：

   • Windows: C:\Users\[You]\Documents\Ableton\User Library\Remote Scripts\

   • Mac: ~/Library/Preferences/Ableton/Live [Version]/User Remote Scripts/

2. AbletonMCP というフォルダーを作成します。

3. AbletonMCP_Remote_Script/__init__.py をこのフォルダーにコピーします。

3. Abletonの設定

1. Ableton Liveを開きます。

2. Preferences → Link, Tempo & MIDI に移動します。

3. Control Surface を "AbletonMCP" に設定します。

4. Input/Output を "None" に設定します。

4. AIアシスタントの接続

Claude Desktopの場合:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["C:/path/to/ableton-mcp-extended/MCP_Server/server.py"]
    }
  }
}

Cursorの場合: Settings → MCP に、同じパスでMCPサーバーを追加します。

5. 制作を開始！

AIアシスタントを開いて、以下のように試してみてください：

• "ピアノで新しいMIDIトラックを作成して"

• "シンプルなドラムビートを追加して"

• "現在どんなトラックがある？"

仕組み

graph TB
    A[You: Natural Language] --> B[AI Assistant]
    B --> C[MCP Server]
    C --> D[Ableton Remote Script]
    D --> E[Ableton Live API]
    E --> F[🎵 Your Music]
    
    G[ElevenLabs AI] --> H[Generated Audio]
    H --> C

1. AIアシスタントに対して平易な英語でコマンドを発行します（例：「新しいMIDIトラックを作成して『Bass』と名付けて」）。

2. AIアシスタントが意図を理解し、MCPサーバーから適切なツールを呼び出します。

3. MCPサーバー (server.py) がツール呼び出しを受け取り、特定のJSONコマンドを構築します。

4. Live内で実行されているAbleton Remote Script (init.py) が、ソケット接続を介してJSONコマンドを受け取ります。

5. Remote Scriptが公式のAbleton Live APIを使用してコマンドを実行し、セッションに変更を即座に反映させます。

高度な機能

超低遅延のリアルタイムパラメーター制御用：

# Install the hybrid server
cp -r Ableton-MCP_hybrid-server/AbletonMCP_UDP/ ~/Remote\ Scripts/AbletonMCP_UDP/

# Try the XY Mouse Controller example
cd experimental_tools/xy_mouse_controller
python mouse_parameter_controller_udp.py

これは以下の構築方法を示しています：

• Ableton用のカスタムリアルタイムコントローラー

• 表現力豊かなパフォーマンスツール

• インタラクティブな音楽アプリケーション

このリポジトリは、ElevenLabs用などの他のMCPサーバーと統合して、オーディオを生成しプロジェクトに直接インポートできます。

ElevenLabs MCPサーバーをその指示に従ってセットアップしてください。

AIアシスタントの設定を更新して、両方のサーバーを含めます。

mcp-config.jsonの例:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["/path/to/ableton-mcp-extended/server.py"]
    },
    "ElevenLabs": {
      "command": "python",
      "args": ["/path/to/elevenlabs_mcp/server.py"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key-here"
      }
    }
  }
}

コンポーネントの概要

このプロジェクトには、いくつかの専門的なコンポーネントが含まれています：

コアMCPサーバー

• 信頼性の高いAI制御のための標準TCP通信

• 広範なAbleton Live API統合

• Claude Desktop、Cursor、Gemini CLIと互換性あり。

ハイブリッドTCP/UDPサーバー

• 高性能なリアルタイムパラメーター制御

• ライブパフォーマンスのための超低遅延

• コントローラーやインタラクティブツールに最適

ElevenLabs統合

• プロフェッショナルなテキスト読み上げ生成

• カスタム音声の作成とクローン

• Abletonセッションへの直接インポート

• リアルタイムSFX生成

実験的なツールと例

• XYマウスコントローラー: カスタムAbletonコントローラーの構築方法を示す例

• 拡張可能なフレームワーク: 独自の制御インターフェースを作成するための基盤

• 概念実証: MCPアプローチの力と柔軟性を示す

ドキュメント

• インストールガイド - 詳細なセットアップ手順

• ユーザーガイド - 何を、どれを、どのように

コミュニティとサポート

• GitHub Issues: バグ報告と機能リクエスト

• Discussions: 作品を共有したり、助けを得たりする場所

作品を共有する

AIで生成した実験作品にタグを付けてください！コミュニティが何を作るのかを見るのが大好きです：

YouTube | Instagram | Patreon | Website

今後の予定

• オートメーションポイント配置のバグ修正

• ~~VSTプラグインサポート - サードパーティ製プラグインの制御 [「Configure」パラメーター機能を通じて実現可能ですが]~~ → 完了！

• アレンジメントビュー - 完全なタイムライン制御

• ハードウェア統合 - AIを介したMIDIコントローラーのブリッジ

• 高度なAI - より賢く、より優れた音楽の理解と生成

ライセンスとクレジット

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

使用技術:

• Model Context Protocol - AI統合フレームワーク

• ElevenLabs API - プロフェッショナルな音声生成

• Ableton Live - デジタルオーディオワークステーション

インスピレーション: オリジナルの ableton-mcp プロジェクト

音楽制作コミュニティへの愛を込めて作成されました

このプロジェクトがあなたの創造性に役立つなら、ぜひ⭐スターを付けてください！