Lacuna MCP

lacuna-mcp

Lacuna Music API 用の Model Context Protocol サーバーです。MCP 対応クライアント（Claude Desktop、Claude Code、Cursor、Zed、Continue など）で、エージェントのループの一環として AI 音楽を生成できます。

SDK または CLI をお探しですか？lacuna-sdk と lacuna-toolkit をご覧ください。

---

インストール

このサーバーは単一の npm パッケージとして公開され、stdio 経由で動作します。インストールは不要です。MCP クライアントが npx 経由で起動します。

npx lacuna-mcp

設定

サーバーは環境変数から設定を読み込みます。

変数	必須	説明
LACUNA_API_KEY	はい	プロフィールダッシュボードで取得できる API キーです。lyr_live_ で始まります。
LACUNA_BASE_URL	いいえ	API のベース URL を上書きします（ステージング環境など）。

Music API にアクセスするには、Pro プラン以上が必要です。

Claude Desktop

claude_desktop_config.json にエントリーを追加します。

{
  "mcpServers": {
    "lacuna": {
      "command": "npx",
      "args": ["-y", "lacuna-mcp"],
      "env": {
        "LACUNA_API_KEY": "lyr_live_..."
      }
    }
  }
}

設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add lacuna -- npx -y lacuna-mcp

次に、シェルでキーをエクスポートするか、クライアントの MCP 設定から指定します。

Cursor / Zed / その他の MCP クライアント

stdio 経由で Model Context Protocol を使用するクライアントであれば、コマンドとして npx -y lacuna-mcp を実行し、環境変数として LACUNA_API_KEY を渡せます。正確な JSON の形式については、クライアントの MCP セットアップドキュメントを参照してください。

---

ツール

ツール	説明
generate_music	音楽生成タスクを作成します。直ちに pending 状態のタスクを返します。
get_generation	ID を指定して、生成タスクの現在の状態を取得します。
wait_for_generation	タスクが終端状態（ready または failed）に達するか、タイムアウトになるまでポーリングします。

generate_music

パラメーター	型	説明
style	string (required)	スタイルの説明。例："pop, female vocal, 120 bpm, energetic"。
title	string (required)	トラックのタイトル。
lyrics	string	instrumental が true の場合を除き、必須です。
instrumental	boolean	インストゥルメンタルトラックを生成します。デフォルトは false です。
model	"aether" | "echo"	生成モデル。デフォルトは aether（Lacuna Aether）です。
vocal_gender	"m" | "f"	リードボーカルのヒント（aether のみ）。
negative_tags	string	避けるスタイルタグ（aether のみ）。
style_weight	number (0–1)	aether のみ。
weirdness_constraint	number (0–1)	aether のみ。
audio_weight	number (0–1)	aether のみ。

クレジットは作成時に差し引かれ、上流プロバイダーで障害が発生した場合は自動的に返金されます。

get_generation

パラメーター	型	説明
id	string	生成タスク ID。generate_music によって返されます。

wait_for_generation

パラメーター	型	説明
id	string	生成タスク ID。
poll_interval_seconds	number	ポーリング間隔。デフォルトは 5 です。
timeout_seconds	number	合計タイムアウト。デフォルトは 600（10 分）です。

---

必要条件

• Node.js 18 以降。
• Lacuna Pro プラン以上の API キー。

---

ライセンス

MIT © Louis Tsang