Lacuna Music — MCP-сервер для Claude Code: генерация музыки
Сервер передаёт агенту инструменты Lacuna Music для создания музыкальных треков и проверки их статуса. Пригодится, когда нужно получить музыку по описанию стиля и тексту песни.
claude mcp add --transport http lacuna-mcp https://www.lacuna.fm/mcpЧто делает Lacuna Music
MCP-сервер подключает Lacuna Music к агенту. Через generate_music можно задать название, описание стиля и текст песни; для инструментального трека текст не требуется. Запрос возвращает задачу, а get_generation проверяет её состояние. Инструмент wait_for_generation опрашивает задачу до готового или ошибочного статуса либо до истечения времени ожидания.
Доступны модели aether и echo. Настройки вокала и параметры стиля относятся к aether. Для локального запуска через npm нужны Node.js 18 или новее и ключ API плана Pro или выше; ключ передаётся через LACUNA_API_KEY. Без подходящего плана генерация музыки через API недоступна.
Какие задачи решает
- создать музыкальный трек по описанию стиля
- сгенерировать инструментальную композицию
- проверить состояние задачи генерации
- дождаться готового результата или ошибки
Примеры запросов агенту
- Создай трек «Утренний город» в стиле инди-поп с текстом о поездке домой.
- Сгенерируй инструментальную композицию для спокойной сцены в игре.
- Проверь задачу генерации с идентификатором
abc123.
Как установить Lacuna Music
1Командой платформы: удалённый сервер
claude mcp add --transport http lacuna-mcp https://www.lacuna.fm/mcp2Командой платформы
claude mcp add --env LACUNA_API_KEY=<LACUNA_API_KEY> --env LACUNA_BASE_URL=<LACUNA_BASE_URL> --transport stdio mcp -- npx -y lacuna-mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add mcp --url https://www.lacuna.fm/mcp2Командой платформы
codex mcp add mcp --env LACUNA_API_KEY=<LACUNA_API_KEY> --env LACUNA_BASE_URL=<LACUNA_BASE_URL> -- npx -y lacuna-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"url": "https://www.lacuna.fm/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"lacuna-mcp"
],
"env": {
"LACUNA_API_KEY": "<LACUNA_API_KEY>",
"LACUNA_BASE_URL": "<LACUNA_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "http",
"url": "https://www.lacuna.fm/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"lacuna-mcp"
],
"env": {
"LACUNA_API_KEY": "<LACUNA_API_KEY>",
"LACUNA_BASE_URL": "<LACUNA_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp https://www.lacuna.fm/mcp2Командой платформы
gemini mcp add -e LACUNA_API_KEY=<LACUNA_API_KEY> -e LACUNA_BASE_URL=<LACUNA_BASE_URL> mcp npx -y lacuna-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Lacuna Music
Как установить Lacuna Music в Claude Code?
Добавьте сервер командой claude mcp add --transport http lacuna-mcp https://www.lacuna.fm/mcp.
Что делает Lacuna Music?
Он даёт MCP-клиенту инструменты для создания музыки через Lacuna Music API и проверки состояния генерации.
Что нужно для генерации музыки?
Нужен ключ API плана Pro или выше. Для локального запуска пакета через npm также требуется Node.js 18 или новее.
