Ableton Live MCP Server

🚀 能力登 Live MCP サーバー

能力登 Live MCP サーバー は、モデルコンテキストプロトコル (MCP) を実装したサーバーで、LLM（大規模言語モデル）と Ableton Live 間の通信を促進します。OSC（オープンサウンドコントロール） を使用して、能力登 Live へのメッセージの送信と受信を行います。この実装は AbletonOSC に基づいており、利用可能な OSC アドレスをすべて ツール にマッピングし、MCP クライアントからアクセスできるようにしています。

このプロジェクトは主に2つの部分で構成されています。

• mcp_ableton_server.py：クライアントと OSC エージェント間の通信を処理する MCP サーバー。
• osc_daemon.py：能力登 Live へのコマンドの転送と応答の処理を担当する OSC エージェント。

🚀 クイックスタート

能力登 Live MCP サーバーは、LLM と Ableton Live の間の通信を可能にするサーバーです。以下では、このサーバーの機能、インストール方法、使用方法などについて説明します。

✨ 主な機能

• MCP クライアントから能力登 Live を制御するための MCP 互換 API を提供します。
• python-osc を使用して OSC 通信を行います。
• AbletonOSC に基づく OSC 実装を利用しています。
• 能力登 Live のコマンドを処理するためのリクエスト - レスポンス処理を実装しています。

📦 インストール

必要条件

• Python 3.8 以上
• python-osc（OSC 通信に使用）
• fastmcp（MCP サポートに使用）
• uv（推奨の Python パッケージインストールツール）
• AbletonOSC をコントロールサーフェイスとして使用

インストール手順

1. uv をインストールします（https://docs.astral.sh/uv/getting-started/installation）：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. リポジトリをクローンします：

   git clone https://github.com/your-username/mcp_ableton_server.git
   cd mcp_ableton_server
   

3. プロジェクトとその依存関係をインストールします：

   uv sync
   

4. AbletonOSC をインストールします。

📚 ドキュメント

構成ファイルについて

• mcp_ableton_server.py：MCP サーバーのエントリーポイントです。
• osc_daemon.py：能力登 Live との通信を処理する OSC エージェントです。
• resources：プロジェクトのリソースを含むフォルダです。
• LICENSE：ライセンスファイルです。

💻 使用例

基本的な使用法

MCP サーバーの起動

python mcp_ableton_server.py

OSC エージェントの起動

python osc_daemon.py

🤑 FAQ

Q：プロジェクトをどのように設定しますか？

A：CONFIG ファイルを参照してください。

Q：問題が発生した場合、どうすればいいですか？

A：ISSUE を提出するか、メンテナーに連絡してください。

🚀 貢献の方法

このプロジェクトの改善のために、問題の報告、機能要求、またはプルリクエストの送信を歓迎します。

📄 ライセンス

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

謝辞

以下のプロジェクトと人物に感謝します。

• モデルコンテキストプロトコル (MCP)
• python-osc（OSC 処理に使用）
• Daniel John Jones と OSC 実装の AbletonOSC
• 能力登のサードパーティリモートスクリプト
• Julien Bayle @Structure Void からの啓発とリソース。

TODO

• リソース と ヒント のプロトタイプ機会を探索します。
• 独立した能力登 Live MCP クライアントを構築します。