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 集成