Lacuna Music

io.github.JOYLINK-LTD由 GitHub 帳號 JOYLINK-LTD 發布v0.3.4更新於 Oct 24, 2026

Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.

發布方自己的服務:Prediction Market Intelligence

已驗證Streamable HTTP可網頁執行媒體與設計AI 與機器學習

概覽

AI 產生的概覽

Lacuna Music MCP 伺服器,讓助理建立 AI 音樂生成任務、查詢任務狀態並列出可用模型。

可以做什麼
  • 依風格描述、標題、可選歌詞或純音樂選項、模型與調校參數建立音樂生成任務
  • 依任務 id 查詢生成狀態,完成後取得成品曲目與音訊連結
  • 輪詢等待任務直到完成或逾時
  • 列出可用音樂模型及其每任務點數消耗、每任務曲目數與語言涵蓋範圍
適用情境
適合在代理流程中需要產生原創 AI 音樂或純音樂的情況,例如依風格提示與歌詞草擬曲目,再於生成完成後取回音訊連結。
執行需求
需要 Node.js 18 或更新版本,透過 npx 以 stdio 執行 npm 套件,或使用遠端端點。需要 Pro 以上方案的 Lacuna API 金鑰,放在 LACUNA_API_KEY 環境變數中;LACUNA_BASE_URL 可覆寫 API 基礎位址。需要連線至 Lacuna API 的網路。
安裝前請注意
API 金鑰是放在環境變數中的機密,請勿寫入共用設定。生成會消耗點數,建立任務時扣除,僅在上游供應商失敗時自動退還。音樂功能需要付費的 Pro 以上方案。生成的音訊託管於 Lacuna 並以連結形式回傳。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Lacuna Music,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.JOYLINK-LTD%2Flacuna-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "lacuna-music": {
      "type": "http",
      "url": "https://www.lacuna.fm/mcp"
    }
  }
}

README

lacuna-mcp

[npm version] [License: MIT] [Node.js]

Model Context Protocol server for the Lacuna Music API. Lets MCP-compatible clients (Claude Desktop, Claude Code, Cursor, Zed, Continue, etc.) generate AI music as part of an agent loop.

Looking for the SDK or CLI? See lacuna-sdk and lacuna-toolkit.


Installation

The server is published as a single npm package and runs over stdio. No install step is needed — your MCP client launches it via npx.

sh
npx lacuna-mcp

Configuration

The server reads its configuration from environment variables:

VariableRequiredDescription
LACUNA_API_KEYyesAPI key from your profile dashboard. Begins with lyr_live_.
LACUNA_BASE_URLnoOverride the API base URL (e.g. for staging).

Music API access requires the Pro plan or above.

Claude Desktop

Add an entry to claude_desktop_config.json:

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

The config file lives at:

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

Claude Code

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

Then export the key in your shell or set it via your client's MCP settings.

Cursor / Zed / other MCP clients

Any client that speaks the Model Context Protocol over stdio can run npx -y lacuna-mcp as the command and pass LACUNA_API_KEY as an env var. Refer to your client's MCP setup docs for the exact JSON shape.


Tools

ToolDescription
generate_musicCreate a music generation task. Returns a pending task immediately.
get_generationRetrieve the current state of a generation task by id.
wait_for_generationPoll a task until it reaches a terminal state (ready or failed) or the timeout elapses.

generate_music

ParameterTypeDescription
stylestring (required)Style description, e.g. "pop, female vocal, 120 bpm, energetic".
titlestring (required)Track title.
lyricsstringRequired unless instrumental is true.
instrumentalbooleanGenerate an instrumental track. Default false.
model"aether" | "echo"Generation model. Defaults to aether (Lacuna Aether).
vocal_gender"m" | "f"Lead vocal hint (aether only).
negative_tagsstringStyle tags to avoid (aether only).
style_weightnumber (0–1)aether only.
weirdness_constraintnumber (0–1)aether only.
audio_weightnumber (0–1)aether only.

Credits are deducted on creation and refunded automatically if the upstream provider fails.

get_generation

ParameterTypeDescription
idstringGeneration task id, returned by generate_music.

wait_for_generation

ParameterTypeDescription
idstringGeneration task id.
poll_interval_secondsnumberPolling interval. Default 5.
timeout_secondsnumberTotal timeout. Default 600 (10 minutes).

Requirements

  • Node.js 18 or newer.
  • An API key from a Lacuna Pro plan or above.

License

MIT © Louis Tsang

來源:packages/mcp/README.md,提交 0b19ff9

工具

3

generate_music

Generate music

Create an AI music generation task on Lacuna. Returns immediately with a `pending` task; poll `get_generation` to retrieve the finished tracks and their audio URLs.

輸入參數modelstyle必填title必填lyricsaudio_weightinstrumentalstyle_weightvocal_gendernegative_tagsweirdness_constraint

get_generation

Get generation

Retrieve the current state of a music generation task by id. Status is `pending`, `ready`, or `failed`; audio URLs appear on `ready`.

輸入參數id必填

list_models

List models

List the music models available through the API, with their credit cost per task, tracks produced per task, and language coverage.

無需輸入參數。

版本歷史

1
  1. v0.3.4最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Lacuna 整合