lacuna-music — плагин для Claude Code: что делает и как установить
Плагин lacuna-music для Claude Code и Codex генерирует инструментальные треки и песни с вокалом по тексту через MCP-сервер Lacuna. Создаёт музыку для озвучки прототипов и фонового сопровождения.
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install lacuna-music@awesome-codex-pluginsЧто делает lacuna-music
Плагин подключает к ассистенту сервер [email protected] через stdio. Он предоставляет три инструмента: generate_music для запуска генерации, get_generation для проверки статуса и wait_for_generation для ожидания готовых ссылок на аудио. Агент может создать инструментальный трек по описанию жанра или превратить готовый текст песни в трек с вокалом.
Сервер сразу возвращает идентификатор фоновой задачи, поэтому клиент опрашивает статус примерно каждые 10 секунд. Каждая генерация расходует кредиты в учётной записи Lacuna.
Для запуска нужен Node.js 18 или новее, тарифный план Pro или выше на сайте Lacuna и переменная окружения LACUNA_API_KEY со скоупом music:generate. Без платной подписки Pro сервис работать не будет.
Какие задачи решает
- сгенерировать инструментальный трек по текстовому описанию стиля
- записать песню с вокалом на основе переданного текста
- получить прямые ссылки на сгенерированные аудиофайлы
Примеры запросов агенту
- Сделай лёгкий джазовый инструментал для фоновой музыки
- Напиши песню с женским вокалом на этот текст в стиле поп-рок
- Проверь статус задачи генерации трека и верни аудиофайл
Как установить lacuna-music
Через маркетплейс плагинов
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install lacuna-music@awesome-codex-pluginsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о lacuna-music
Как установить lacuna-music в Claude Code?
Выполните команду /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install lacuna-music@awesome-codex-plugins. После установки экспортируйте переменную окружения LACUNA_API_KEY.
Что делает плагин lacuna-music?
Он связывает ассистента с сервисом Lacuna, позволяя запускать генерацию музыки и вокальных композиций прямо из чата.
Что требуется для работы генерации?
Нужны установленный Node.js версии 18+, тариф Pro или выше в сервисе Lacuna и API-ключ LACUNA_API_KEY с разрешением music:generate.
Исходный текст
lacuna-plugin · MIT
# Lacuna Music Plugin Generate original instrumental music and vocal songs from Claude Code or Codex using Lacuna's published Model Context Protocol server. ## Capabilities - Generate an instrumental from a natural-language style description. - Turn supplied lyrics into a complete song with vocals. - Retrieve a generation or wait until its audio URLs are ready. Music generation spends credits from the authenticated Lacuna account. The MCP server returns a pending task immediately; clients should poll approximately every 10 seconds rather than busy-looping. ## Requirements - A [Lacuna account](https://www.lacuna.fm/login) on Pro or higher. - A `LACUNA_API_KEY` created at [Lacuna API settings](https://www.lacuna.fm/profile/api) with the `music:generate` scope. - Node.js 18 or newer so the client can launch the pinned `[email protected]` package. ## Install in Claude Code ```sh /plugin marketplace add JOYLINK-LTD/lacuna-plugin /plugin install lacuna-music@lacuna ``` Export `LACUNA_API_KEY` in the environment Claude Code runs in, then run `/reload-plugins` if the install summary asks for it. ## Install in Codex ```sh codex plugin marketplace add JOYLINK-LTD/lacuna-plugin codex plugin add lacuna-music@lacuna ``` Make `LACUNA_API_KEY` available to Codex, restart the app, and test the plugin in a new task. ## Tools | Tool | Purpose | | --- | --- | | `generate_music` | Creates a generation task and returns its pending task ID. | | `get_generation` | Retrieves the current state of a generation task. | | `wait_for_generation` | Polls until a task becomes `ready` or `failed`. | ## Repository layout - `.claude-plugin/marketplace.json` — installable Claude Code marketplace. - `.claude-plugin/plugin.json` — Claude Code plugin manifest (MCP server declared inline). - `.agents/plugins/marketplace.json` — installable Codex marketplace. - `.codex-plugin/plugin.json` — Codex plugin manifest. - `.mcp.json` — pinned stdio MCP connection (Codex schema; Claude Code reads its own copy from `.claude-plugin/plugin.json`). See the [MCP documentation](https://www.lacuna.fm/docs/mcp) and [Lacuna Toolkit](https://github.com/JOYLINK-LTD/lacuna-toolkit) for the SDK, CLI, and standalone MCP package. ## Security Do not commit or paste a Lacuna API key into this repository. See [SECURITY.md](SECURITY.md) for reporting instructions. ## License MIT
© JOYLINK LTD · MIT · hashgraph-online/awesome-codex-plugins