Taoyuan Music

Escribe una canción original para una persona: describe para quién es, obtén la letra, dos versiones completas y la portada en aproximadamente un minuto. OAuth o clave API, 3 créditos gratuitos. Funciona en Claude, ChatGPT, Cursor, Coze.

GitHub

Servidor MCP alojado

npx add-mcp 'https://api.musicsforyou.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Taoyuan MCP — escribe una canción para una persona

Dile a tu asistente de IA para quién es la canción. Aproximadamente un minuto después recibes la letra, dos versiones completas y la portada.
Funciona en Claude Desktop, Claude Code, ChatGPT, Cursor, Coze y cualquier cliente MCP u OpenAPI.

Documentación · OpenAPI · llms.txt · 中文

"Escribe una canción de cumpleaños cálida para mi mamá que cumple 60 — le encanta cantar en la cocina."

→ 《Kitchen Radio》, 2 × 2:30 MP3, letra, portada. Una llamada de herramienta, un crédito.

Inicio rápido

Claude Desktop — añade a claude_desktop_config.json:

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

Claude Code / Cursor / cualquier cosa que hable MCP remoto — sin instalación:

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

Cursor (un clic) — Añadir a Cursor desde la página de desarrolladores, o mcp.json en este repositorio (inicio de sesión OAuth en el primer uso).

Conectores claude.ai / ChatGPT — añade la URL https://api.musicsforyou.com/mcp; el inicio de sesión OAuth está integrado, no se necesita clave.

REST — una llamada, canción terminada de vuelta:

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}'

Obtén una clave en https://www.musicsforyou.com/developers. Las claves nuevas incluyen 3 créditos gratis. La generación cuesta 1 crédito por llamada (recibes dos versiones); compilar y revisar es gratis.

Herramientas

Herramienta	Costo	Qué hace
`create_song`	1 crédito	Una llamada: para quién es la canción → letra + dos versiones completas + portada (el servidor espera hasta 180 s)
`compile_music_prompt`	gratis	Convierte una solicitud en título / letra / estilo para que el usuario pueda leerla primero
`revise_generation_prompt`	gratis	Aplica una edición ("estribillo más fuerte", "voz femenina") a un plan
`generate_music`	1 crédito	Envía un plan; devuelve un id de generación (dos versiones)
`get_generation`	gratis	Consulta; admite `waitSeconds` long-poll
`replace_section`	1 crédito	Rehace solo una parte de una canción terminada
`separate_stems`	gratis una vez por canción	Separación de voces / instrumental (separación de 12 pistas necesita Pro)
`list_tracks` `list_presets` `get_credit_balance` `get_purchase_link`	gratis	Biblioteca, escenas, balance, enlace de pago Stripe

El servidor también expone prompts de MCP (cumpleaños, boda, intro de podcast…) y recursos (tarjetas de conocimiento de escenas, detalles de pistas).

Cómo funciona

Taoyuan no es un envoltorio crudo de texto a música. Tu frase pasa por un compilador de composición que decide estructura, imágenes y lenguaje, escribe letras seccionadas en segunda persona y elige un estilo; el resultado se genera como dos candidatos completos con portada. La letra se escribe a partir de la historia, nunca se copia del prompt. Idiomas: chino, cantonés, inglés, japonés.

Autenticación: clave API (ty_live_…) u OAuth 2.1 (PKCE, registro dinámico de clientes) — https://api.musicsforyou.com/.well-known/oauth-authorization-server
Límites de tasa: 10 llamadas / min, 300 / día por clave
Webhooks: PUT /v1/api-keys/:id/webhook → firmado con HMAC generation.finished
Precios: 10 canciones US$9.9 · 50 canciones US$39 (tarjeta, WeChat Pay, Alipay)

Ejemplos

examples/claude_desktop_config.json
examples/openai-agents.py — OpenAI Agents SDK sobre MCP
examples/curl.sh — REST de una sola llamada

Este paquete

taoyuan-mcp es un pequeño proxy stdio → Streamable HTTP (37 líneas). Las definiciones de herramientas viven en el servidor, por lo que el paquete nunca queda desactualizado. Entorno: TAOYUAN_API_KEY (requerido), TAOYUAN_MCP_URL (anulación opcional).

Privacidad y términos

Las canciones que generes son tuyas para usar, incluso comercialmente en los planes de pago. Términos · Privacidad · Soporte: 2368082693@qq.com

中文

桃源 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，支持微信、支付宝、银行卡。

Licencia: MIT