Reference MCP Tools

MCP ツール リファレンス

Claude Code から呼ぶツールの一覧です。名前は live.<対象>.<動詞>。番号は全て 0 始まりで、live.set.read で確認した値をそのまま渡します。結果は JSON テキストで返ります。

接続・調査

live.status

LiveMCP デバイスと Live 本体の接続状態を確認します。Live のバージョンが返れば接続完了です。引数なし。

live.debug.state

ブリッジの疎通状況。node.script のインレットに届いたメッセージ履歴（自己診断の device_loaded / bridge_ready js）、保留中のブリッジ呼び出し数、サンプルフォルダ設定を返します。無応答の切り分けに使います。引数なし。

live.api.info

LiveAPI パスの型・対応プロパティ・関数一覧を実機から取得します。ツール化していない LOM を調べるときに。

引数	型	内容
path	string	LiveAPI パス（例 live_app / live_set / live_set tracks 0 clip_slots 0）

live.api.raw

任意の LiveAPI 呼び出しを実行する低レベル手段。

引数	型	内容
path	string	LiveAPI パス
method	get / getcount / set / call	呼び出し種別
property	string	プロパティ名または関数名
args	(string | number)[]	set / call に渡す引数（任意）

セットの読み取り

live.set.read

テンポ・トラック・クリップ・デバイス構成の概要。操作前の現状把握に使います。

引数	型	内容
includeClips	boolean	クリップスロットの詳細も含める（既定 true）

サンプル検索

live.samples.search

登録済みサンプルフォルダからオーディオファイルを検索し、絶対パスを返します。結果はそのまま live.clip.create_audio や live.device.replace_sample に渡せます。

引数	型	内容
query	string	検索語（空白区切り AND。省略時は全件）
folder	string	検索対象フォルダの絶対パス（省略時は設定済みフォルダ）
limit	1〜100	最大件数（既定 25）

フォルダ設定は セットアップ の「サンプルフォルダ」を参照。

クリップ

live.clip.create_audio

オーディオファイルをセッションビューのクリップスロットに配置します。対象はオーディオトラックのみ。

引数	型	内容
trackIndex	int	トラック番号
sceneIndex	int	シーン（クリップスロット）番号
filePath	string	オーディオファイルの絶対パス

live.clip.create_audio_batch

複数ファイルを 1 トラックの連続するシーンへ順に配置します。16 件ずつブリッジへ投げ、1 件失敗しても続行して errors に理由を残します。

引数	型	内容
trackIndex	int	トラック番号
startSceneIndex	int	先頭のシーン番号
filePaths	string[]	絶対パス（この順に上から並ぶ）

戻り値: { created, failed, clips, errors }

Drum Rack

live.drumrack.build

MIDI トラックに Drum Rack を用意し、ワンショット群を startNote から半音ずつパッドへ割り当てます。既に Drum Rack があれば再利用します。パッド 1 枚につき insert_chain → in_note → Simpler 挿入 → replace_sample → 命名 の 5 手順で、6 件ずつブリッジへ投げます。

引数	型	内容
trackIndex	int	MIDI トラック番号
filePaths	string[]	絶対パス（この順に音程が上がる）
startNote	0〜127	先頭パッドの MIDI ノート（既定 24 = Ableton 表記の C0）
names	string[]	各パッドの名前（省略時はファイル名から）

先頭 + 件数 − 1 が 127 を超えるとエラーになります。戻り値: { device_index, added, failed, pads, errors }

実機の目安: ワンショット 300 件 / 7 トラックで失敗 0。101 パッドを半音で並べるのは網羅であって演奏性ではないので、楽器別に分ける改善が Issue #2 / #28 で計画されています。

デバイス

live.device.insert

ネイティブデバイス（Simpler / Drum Rack / EQ Eight 等）をトラックに追加します。

引数	型	内容
trackIndex	int	トラック番号
deviceName	string	デバイス名（例 Simpler, Drum Rack）
position	int	挿入位置（省略時は末尾）

live.device.replace_sample

Simpler にサンプルを読み込みます（Live 12.4+）。

引数	型	内容
trackIndex	int	トラック番号
deviceIndex	int	トラック内デバイス番号
filePath	string	オーディオファイルの絶対パス

live.device.params

デバイス（M4L デバイス含む）の公開パラメータ一覧を値・レンジ付きで返します。

引数	型	内容
trackIndex	int	トラック番号
deviceIndex	int	トラック内デバイス番号

live.device.set_param

引数	型	内容
trackIndex	int	トラック番号
deviceIndex	int	トラック内デバイス番号
paramIndex	int	パラメータ番号（live.device.params で確認）
value	number	設定値（min/max の範囲内）

.als ファイル系

動いているセットではなく ファイルを書き換える系統です。Live を経由しません。

live.set.group_tracks

セット（.als）の中で連続したトラックを Group トラックにまとめます。LOM に無い操作のためファイル側で行います。

引数	型	内容
groupName	string	グループ名（例 ONE SHOTS）
tracks	string[]	対象トラック。名前の前方一致（例 "OS "）またはトラック Id の数字
setPath	string	.als の絶対パス。省略時は Live が最後に開いたセット
output	string	出力先。省略時は同じファイルを置き換え（直前の状態は Backup/ へ退避）
open	boolean	書き出し後に Live で開く（既定 false）

挙動:

• 対象セットが Live で開いたままのときは書かずにエラー文言で状況と選択肢を返します（別のセットを開いてから再実行 / output に別パス）。進め方は会話で決めます
• 結果は Live のステータスバーへ通知します（Remote Script 導入時）
• open: true で Live に渡すと、未保存の変更があれば Live 純正の保存ダイアログが出ます

戻り値: { output, group_name, group_id, grouped_tracks, backup, opened, note }

ツールを追加するには

開発 の「ツールの追加」を参照。