io.github.erliona由 GitHub 账号 erliona 发布v0.1.1更新于 Nov 2, 2026
Generate Suno AI music (v5.5) from any MCP client. Async; billed only on success.
托管式 MCP 服务器，让助手根据文字提示生成 Suno AI 音乐，并取回成品音频链接。
Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.erliona%2Ftunova/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"tunova": {
"type": "http",
"url": "https://api.tunova.ai/mcp",
"headers": {
"X-API-Key": "<YOUR_API_KEY>"
}
}
}
}Tiny, zero-dependency clients + MCP manifest for the Tunova music API — generate music with Suno (v5.5) over a simple REST or MCP interface. Generation is async and billed only on success: a failed render refunds itself.
python/tunova.py — stdlib only, Python 3.8+.node/tunova.ts — Node 18+ (fetch built in).server.json — hosted Streamable-HTTP server at https://api.tunova.ai/mcp.Get a key (50 free tokens, no card) at https://tunova.ai. Full reference: https://api.tunova.ai/docs · live status: https://tunova.ai/status.
Tunova is an independent service, not affiliated with or endorsed by Suno. Tracks come from paid Suno plans; review Suno's terms for your use case.
Prefer no install? python/tunova.py is stdlib-only — vendor the single file and import it.
Both generate() calls submit a job and poll until the track is delivered. Prefer fire-and-forget?
Use submit() with a callback_url and take an HMAC-signed webhook instead.
Tools: generate_song · wait_for_song · check_song. Same API key, same billed-on-success rule.
If you pass callback_url, Tunova POSTs the terminal job with
X-Webhook-Signature: sha256=<hmac> over <X-Webhook-Timestamp>.<rawBody>, keyed with your
whsec_… secret (view/rotate it on the dashboard's API-keys page). Verify against the raw body
before parsing — both SDKs ship a verifier (Tunova.verify_webhook / verifyWebhook).
MIT — see LICENSE. The SDK code is yours to use freely; your use of the Tunova API is governed by the terms.
来源：README.md，提交 580dbd0
Start generating a song with Suno. Returns immediately with a job_id — a full render takes 1-3 minutes, so this does NOT return audio. After calling this, call wait_for_song with the returned job_id to get the audio URL when ready. Costs 10 tokens, billed only on success.
tagsmodeltitlecustomprompt必填instrumentalidempotency_keyWait for a song job to finish and return the audio when ready. Polls server-side for up to ~45 seconds. If the song is ready, returns the clips with audio URLs. If it is still rendering, returns its status so you can call wait_for_song again with the same job_id. Safe to call repeatedly — it only reads status, never starts a new song.
job_id必填max_wait_secondsGet the current status of a song job by job_id — a single check with no waiting. Returns the audio URLs if complete, an error if it failed, or 'processing' if still rendering.
job_id必填已满足适用检查项的 100%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
pip install tunovafrom tunova import Tunova
t = Tunova("sk_live_…")job = t.generate("warm lo-fi piano to study to", model="v5.5")print(job["clips"][0]["audio_url"] if job["status"] == "complete" else job["error"])npm i tunovaimport { Tunova } from "tunova";
const t = new Tunova(process.env.TUNOVA_API_KEY!);const job = await t.generate("warm lo-fi piano to study to", { model: "v5.5" });console.log(job.status === "complete" ? job.clips[0]?.audio_url : job.error);claude mcp add --transport http tunova https://api.tunova.ai/mcp \ --header "X-API-Key: sk_live_…"