Taoyuan Music

Taoyuan MCP — 为一个人写一首歌

告诉 AI 助手这首歌是为谁写的。大约一分钟后，你就能得到歌词、两个完整版本和封面图。
适用于 Claude Desktop、Claude Code、ChatGPT、Cursor、Coze，以及任何 MCP 或 OpenAPI 客户端。

文档 · OpenAPI · llms.txt · 中文

---

“为我 60 岁的妈妈写一首温馨的生日歌——她喜欢在厨房里唱歌。”

→ 《Kitchen Radio》，2 首 × 2:30 的 MP3、歌词、封面。一次工具调用，消耗 1 点额度。

快速开始

Claude Desktop — 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "taoyuan": {
      "command": "npx",
      "args": ["-y", "taoyuan-mcp"],
      "env": { "TAOYUAN_API_KEY": "ty_live_…" }
    }
  }
}

Claude Code / Cursor / 任何支持远程 MCP 的客户端 — 无需安装：

claude mcp add --transport http taoyuan https://api.musicsforyou.com/mcp \
  --header "Authorization: Bearer ty_live_…"

Cursor（一键添加） — 在开发者页面点击 添加到 Cursor，或使用此仓库中的 mcp.json（首次使用时通过 OAuth 登录）。

claude.ai 连接器 / ChatGPT — 添加 URL https://api.musicsforyou.com/mcp；内置 OAuth 登录，无需密钥。

REST — 一次调用，即可获得完整歌曲：

curl https://api.musicsforyou.com/v1/songs \
  -H "Authorization: Bearer ty_live_…" -H "Content-Type: application/json" \
  -d '{"text":"A gentle lullaby for my daughter Mia, she loves the moon","waitSeconds":180}'

在 https://www.musicsforyou.com/developers 获取密钥。新密钥附带 3 点免费额度。每次生成消耗 1 点额度（可获得两个版本）；合成和修改免费。

工具

工具	费用	功能
create_song	1 点额度	一次调用：说明歌曲写给谁 → 返回歌词、两个完整版本和封面（服务端最多等待 180 s）
compile_music_prompt	免费	将请求转换为标题 / 歌词 / 风格，让用户先行查看
revise_generation_prompt	免费	对方案应用修改（“副歌更有力”“女声”）
generate_music	1 点额度	提交方案；返回生成 ID（包含两个版本）
get_generation	免费	轮询；支持 waitSeconds 长轮询
replace_section	1 点额度	仅重做已完成歌曲中的一个部分
separate_stems	每首歌免费一次	人声 / 伴奏分离（12 轨分离需 Pro）
list_tracks list_presets get_credit_balance get_purchase_link	免费	曲库、场景、余额、Stripe 结账链接

服务还提供 MCP 提示词（生日、婚礼、播客开场……）和 资源（场景知识卡、曲目详情）。

工作原理

Taoyuan 并不是一个简单的文本转音乐封装。你的句子会经过一个作曲编译器，由它决定歌曲结构、意象和语言，以第二人称写出分段歌词，并选择风格；随后生成两个完整候选版本和封面图。歌词根据故事创作，绝不照搬提示词。支持的语言：中文、粤语、英语、日语。

• 身份验证：API 密钥（ty_live_…）或 OAuth 2.1（PKCE、动态客户端注册）— https://api.musicsforyou.com/.well-known/oauth-authorization-server
• 速率限制：每个密钥每分钟 10 次调用，每天 300 次
• Webhook：PUT /v1/api-keys/:id/webhook → 由 HMAC 签名的 generation.finished
• 价格：10 首歌 9.9 美元 · 50 首歌 39 美元（银行卡、微信支付、支付宝）

示例

• examples/claude_desktop_config.json
• examples/openai-agents.py — 通过 MCP 使用 OpenAI Agents SDK
• examples/curl.sh — REST 一次性调用

此软件包

taoyuan-mcp 是一个小型 stdio → Streamable HTTP 代理（37 行）。工具定义位于服务端，因此软件包始终保持最新。环境变量：TAOYUAN_API_KEY（必需）、TAOYUAN_MCP_URL（可选覆盖值）。

Privacy & terms

Songs you generate are yours to use, including commercially on the paid plans. Terms · Privacy · Support: [email protected]

---

中文

桃源 MCP：为一个人写一首歌。 在 Claude、ChatGPT、Cursor、扣子里说一句「给我妈 60 岁生日写首歌」，一分钟左右拿到歌词、两个完整版本和封面。

• Claude Desktop：上面的 claude_desktop_config.json 片段，npx -y taoyuan-mcp
• Claude Code / Cursor：claude mcp add --transport http taoyuan https://api.musicsforyou.com/mcp --header "Authorization: Bearer ty_live_…"
• claude.ai / ChatGPT 连接器：填 https://api.musicsforyou.com/mcp，内置 OAuth 登录
• 扣子 / Dify：导入 https://api.musicsforyou.com/openapi-coze.json

API Key 在 https://www.musicsforyou.com/developers 创建，新 Key 送 3 次。生成 1 次扣 1 个额度（两个版本），编译与修改免费。额度包：10 次 US$9.9、50 次 US$39、100 次 ¥300，支持微信、支付宝、银行卡。

License: MIT