Ableton MCP Extended

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

改良版フォーク。 Remote Scriptコマンド22個とMCPツール25個を追加: MIDIノートの読み取り、シーン、セッションクリップのプロパティ、ミキサー（mute/solo/arm、センド）、 Wavetableのモジュレーションマトリックス、undo/redo。 詳細とインストール方法は FORK-NOTES.md を参照してください。

ビデオデモ: 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クリップの作成と命名。

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

  • 単一操作での複数ノートの一括編集。

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

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

  • AbletonのブラウザからURIでインストゥルメントとエフェクトをロード。

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

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

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

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

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

• ブラウザ統合:

  • Abletonのブラウザ内の項目をナビゲートおよび一覧表示。

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

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

• 音声＆オーディオ生成

  • テキスト読み上げ統合: ElevenLabs MCP [同梱] によるナレーション、ボーカルサンプル、音声要素の生成。

  • カスタムボイス作成: トラックにユニークなキャラクターを与えるためのボイスクローン。

  • サウンドエフェクト: AIによるカスタムSFXの作成。

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

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

  • 例: XYマウスコントローラー: MCPフレームワークでカスタムAbletonコントローラーを作成するデモ。

  • 超低レイテンシー: 高性能UDPプロトコルにより、レスポンシブなリアルタイム制御を実現。

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

Related MCP server: io.github.peterkolbe/ableton-for-ai

クイックスタート（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のUser Library Remote Scriptsフォルダを見つけます:

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

   • Mac: ~/Music/Ableton/User Library/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アシスタントにコマンドを発行します（例: "Create a new MIDI track and name it '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サーバーなど、他の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 プロジェクト

音楽制作コミュニティのために❤️を込めて作られました

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