Lacuna MCP

Name: Lacuna MCP
Author: JOYLINK-LTD

@JOYLINK-LTD

关于 Lacuna MCP

Model Context Protocol server for the Lacuna Music API — generate AI music from Claude Desktop, Claude Code, Cursor, Zed, and other MCP-compatible clients.

#music #ai #music-generation #mcp #claude #lacuna

基本信息

分类

开发工具

传输方式

stdio

发布者

JOYLINK-LTD

提交者

Louis Tsang

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

Create a music generation task. Returns a `pending` task immediately.

Retrieve the current state of a generation task by id.

Poll a task until it reaches a terminal state (`ready` or `failed`) or the timeout elapses.

概览

What is Lacuna MCP?

Lacuna MCP is a Model Context Protocol server that integrates with the Lacuna Music API. It enables MCP-compatible clients (Claude Desktop, Claude Code, Cursor, Zed, Continue, etc.) to generate AI music as part of an agent loop.

How to use Lacuna MCP?

The server is a single npm package run over stdio. No install step is needed — your MCP client launches it via npx lacuna-mcp. Configure it by setting the LACUNA_API_KEY environment variable (required, from your profile dashboard, begins with lyr_live_). An optional LACUNA_BASE_URL can override the API base URL. Music API access requires the Pro plan or above.

Key features of Lacuna MCP

Create music generation tasks and get immediate pending task IDs.
Retrieve the current state of a generation task by its ID.
Poll a generation task until it completes or fails.

Use cases of Lacuna MCP

Generate AI music autonomously within an agent workflow.
Check generation status and retrieve completed tracks programmatically.
Integrate music creation into multi-step AI processes.

FAQ from Lacuna MCP

What does Lacuna MCP do exactly?

It exposes three tools — generate_music, get_generation, and wait_for_generation — for creating and monitoring AI music generation tasks via the Lacuna Music API.

What are the prerequisites to use Lacuna MCP?

Node.js 18 or newer, an API key from a Lacuna account on the Pro plan or above, and an MCP-compatible client.

How do I install and configure it?

No installation is needed; run it via npx lacuna-mcp. Set the LACUNA_API_KEY environment variable. For Claude Desktop, add an entry to the mcpServers JSON config; for Claude Code, use claude mcp add.

What runtime or dependencies are required?

Node.js 18+ and a valid API key. The server runs over stdio and is published as an npm package.

Is there a free tier or trial for the API?

The README does not mention a free tier. It states that the Music API requires a Pro plan or above.

开发工具分类下的更多 MCP 服务器

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K