Ableton Vibe

🚀 アブルトンバイブサーバー設定ガイド

このプロジェクトは、AbletonとClaudeを連携させるためのサーバーを設定する手順を提供します。以下の手順に従って、サーバーをセットアップし、Abletonでの操作をClaudeを通じて行えるようにしましょう。

🚀 クイックスタート

📦 インストール

依存関係のインストール

1. yarn をインストールします。ableton-jsはいくつかのビルドスクリプトを実行するために yarn を使用します。

npm install --global yarn

2. pnpm をインストールします。

brew install pnpm

アブルトンバイブサーバーのクローンと実行

1. midi-script をクローンし、Abletonにインストールします。

git clone https://github.com/leolabs/ableton-js.git && cd ableton-js && yarn ableton11:start

2. まだクローンしていない場合は、アブルトンバイブサーバーをクローンします。

git clone https://github.com/androidStern/ableton-vibe.git && cd ableton-vibe && pnpm i

ビルドと変更の監視

npm run build

ClaudeへのMCPの設定

Claudeの設定ファイルは、通常、あなたのマシンの ~/Library/Application Support/Claude/claude_desktop_config.json にあります。以下の内容をこのファイルに追加します。

{
  "mcpServers": {
    "ableton-vibe": {
      "command": "node",
      "args": ["<path-to-repo>/ableton-vibe/ableton-mcp.js"]
    }
  }
}

ここで、<path-to-repo> はあなたがアブルトンバイブをクローンしたパスです。

💻 使用例

基本的な使用法

1. Abletonが実行中であることを確認します。
2. サーバーを使用する前に、Claudeを再起動します。
3. Claudeに「インデックス0のMIDIトラックを作成」と問いかけてみましょう。現在はこの操作しか実行できませんlol。

サポート情報

サポートされるアブルトンバージョン

• Ableton 11との互換性をテスト済みです。Ableton 12は未検証です。

サポートされるオペレーティングシステム

• macOSでのみテストされています。
• Windowsの場合は、ablton-mcp.ts の9行目を変更して一時ディレクトリのロジックを取得する必要があるかもしれません。関連コードは以下の通りです。

const userTempDir = execSync('getconf DARWIN_USER_TEMP_DIR').toString().trim()

🔧 デバッグ

MCPチェックツールを実行して、サーバーを迅速にデバッグします。

npm run inspect

その後、出力に表示されるURLを開きます。インスペクターの使用方法については、こちら を参照してください。

テスト用デバイス追加スクリプト

test-browser.js は、アブルトンセッションにデバイスをプログラムで追加するためのサンプルスクリプトです。実行する際は、以下のことを確認してください。

• Abletonが実行中であること。
• ableton-jsのMIDIリモートコントロールスクリプトがインストールされ、実行されていること。

実行コマンド：

node test-browser.js

🤝 貢献ガイド

現在、すべてのコードは ablton-mcp.ts にあります。ツールやリソースを追加する場合は、このファイルに追加してください。 _JS_ ファイルを編集せず、対応する _TS_ ファイルを編集してください。

🚧 次のステップ

• 正しいビルドとリリースプロセスを設定し、将来的には1つのコマンドですべてのインストールを完了できるようにする。
• 残りのAbleton APIを実装し、MCPツールを通じて自動的に公開する。
• Ableton 12をサポートする。
• テストケースを追加する。
• 他のオペレーティングシステム（Windows）をサポートする。
• 音声制御機能を追加する。