{"id":"0bbdb787-604f-45d2-95a4-eb74775e3712","slug":"taoyuan-mcp","kind":"mcp","name":"taoyuan-mcp","summary":"MCP server that writes an original song for one person — lyrics, two full versions and cover art in about a minute. Works in Claude, ChatGPT, Cursor, Coze.","owner":"JerryYangAI","repoUrl":"https://github.com/JerryYangAI/taoyuan-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-09-30T16:56:55.000Z","addedAt":"2026-10-14T05:14:01.566Z","logoUrl":"https://avatars.githubusercontent.com/u/160254857?u=e7d4b45e9b442ebaf1143c7cc1a9134fdd1ef431&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra","design-media","developer-tools"],"tags":["ai-music","chatgpt","claude","music-generation","openapi","songwriting"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":true,"reviewed":false,"syncedAt":"2026-10-17T13:35:56.703Z","sample":false,"url":"https://conduits.dev/tools/taoyuan-mcp","language":"JavaScript","transports":["stdio"],"install":{"npm":"taoyuan-mcp"},"requirements":{"env":[{"name":"TAOYUAN_API_KEY","secret":true,"required":true,"description":"API key from https://www.musicsforyou.com/developers (starts with ty_live_)"}],"upstreamMayCharge":false},"tools":null,"readme":"

\"Taoyuan\"

\n\n

Taoyuan MCP — write a song for one person

\n\n

\nTell your AI assistant who the song is for. About a minute later you get lyrics, two full versions and cover art.
\nWorks in Claude Desktop, Claude Code, ChatGPT, Cursor, Coze and any MCP or OpenAPI client.\n

\n\n

\n\"npm\"\nDocs ·\nOpenAPI ·\nllms.txt ·\n中文\n

\n\n---\n\n> \"Write a warm birthday song for my mum turning 60 — she loves singing in the kitchen.\"\n>\n> → 《Kitchen Radio》, 2 × 2:30 MP3, lyrics, cover. One tool call, one credit.\n\n## Quick start\n\n**Claude Desktop** — add to `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"taoyuan\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"taoyuan-mcp\"],\n \"env\": { \"TAOYUAN_API_KEY\": \"ty_live_…\" }\n }\n }\n}\n```\n\n**Claude Code / Cursor / anything that speaks remote MCP** — no install:\n\n```bash\nclaude mcp add --transport http taoyuan https://api.musicsforyou.com/mcp \\\n --header \"Authorization: Bearer ty_live_…\"\n```\n\n**Cursor (one click)** — [Add to Cursor](https://www.musicsforyou.com/developers?lang=en#quickstart) from the developers page, or `mcp.json` in this repo (OAuth sign-in on first use).\n\n**claude.ai connectors / ChatGPT** — add the URL `https://api.musicsforyou.com/mcp`; OAuth sign-in is built in, no key needed.\n\n**REST** — one call, finished song back:\n\n```bash\ncurl https://api.musicsforyou.com/v1/songs \\\n -H \"Authorization: Bearer ty_live_…\" -H \"Content-Type: application/json\" \\\n -d '{\"text\":\"A gentle lullaby for my daughter Mia, she loves the moon\",\"waitSeconds\":180}'\n```\n\nGet a key at **https://www.musicsforyou.com/developers**. New keys come with **3 free credits**. Generation costs 1 credit per call (you get two versions); compiling and revising are free.\n\n## Tools\n\n| Tool | Cost | What it does |\n|---|---|---|\n| `create_song` | 1 credit | One call: who the song is for → lyrics + two full versions + cover (server waits up to 180 s) |\n| `compile_music_prompt` | free | Turn a request into title / lyrics / style so the user can read it first |\n| `revise_generation_prompt` | free | Apply an edit (\"stronger chorus\", \"female voice\") to a plan |\n| `generate_music` | 1 credit | Submit a plan; returns a generation id (two versions) |\n| `get_generation` | free | Poll; supports `waitSeconds` long-poll |\n| `replace_section` | 1 credit | Redo only one part of a finished song |\n| `separate_stems` | free once per song | Vocals / instrumental split (12-stem split needs Pro) |\n| `list_tracks` `list_presets` `get_credit_balance` `get_purchase_link` | free | Library, scenes, balance, Stripe checkout link |\n\nThe server also exposes MCP **prompts** (birthday, wedding, podcast intro…) and **resources** (scene knowledge cards, track details).\n\n## How it works\n\nTaoyuan is not a raw text-to-music wrapper. Your sentence goes through a songwriting compiler that decides structure, imagery and language, writes sectioned lyrics in the second person, and picks a style; the result is generated as two full candidates with cover art. Lyrics are written from the story, never copied from the prompt. Languages: Chinese, Cantonese, English, Japanese.\n\n- Auth: API key (`ty_live_…`) or OAuth 2.1 (PKCE, dynamic client registration) — `https://api.musicsforyou.com/.well-known/oauth-authorization-server`\n- Rate limits: 10 calls / min, 300 / day per key\n- Webhooks: `PUT /v1/api-keys/:id/webhook` → HMAC-signed `generation.finished`\n- Pricing: 10 songs US$9.9 · 50 songs US$39 (card, WeChat Pay, Alipay)\n\n## Examples\n\n- [`examples/claude_desktop_config.json`](examples/claude_desktop_config.json)\n- [`examples/openai-agents.py`](examples/openai-agents.py) — OpenAI Agents SDK over MCP\n- [`examples/curl.sh`](examples/curl.sh) — REST one-shot\n\n## This package\n\n`taoyuan-mcp` is a small stdio → Streamable HTTP proxy (37 lines). Tool definitions live on the server, so the package never goes stale. Env: `TAOYUAN_API_KEY` (required), `TAOYUAN_MCP_URL` (optional override).\n\n## Privacy & terms\n\nSongs you generate are yours to use, including commercially on the paid plans. [Terms](https://www.musicsforyou.com/terms) · [Privacy](https://www.musicsforyou.com/privacy) · Support: 2368082693@qq.com\n\n---\n\n## 中文\n\n**桃源 MCP：为一个人写一首歌。** 在 Claude、ChatGPT、Cursor、扣子里说一句「给我妈 60 岁生日写首歌」，一分钟左右拿到歌词、两个完整版本和封面。\n\n- Claude Desktop：上面的 `claude_desktop_config.json` 片段，`npx -y taoyuan-mcp`\n- Claude Code / Cursor：`claude mcp add --transport http taoyuan https://api.musicsforyou.com/mcp --header \"Authorization: Bearer ty_live_…\"`\n- claude.ai / ChatGPT 连接器：填 `https://api.musicsforyou.com/mcp`，内置 OAuth 登录\n- 扣子 / Dify：导入 `https://api.musicsforyou.com/openapi-coze.json`\n\nAPI Key 在 https://www.musicsforyou.com/developers 创建，新 Key 送 3 次。生成 1 次扣 1 个额度（两个版本），编译与修改免费。额度包：10 次 US$9.9、50 次 US$39、100 次 ¥300，支持微信、支付宝、银行卡。\n\nLicense: MIT\n"}