Taoyuan Music

Escreve uma música original para uma pessoa: descreva para quem é, receba letras, duas versões completas e a arte da capa em cerca de um minuto. OAuth ou chave de API, 3 créditos gratuitos. Funciona no Claude, ChatGPT, Cursor, Coze.

GitHub

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Taoyuan MCP — escreva uma música para uma pessoa

Diga ao seu assistente de IA para quem é a música. Cerca de um minuto depois, você recebe a letra, duas versões completas e a arte da capa.
Funciona no Claude Desktop, Claude Code, ChatGPT, Cursor, Coze e em qualquer cliente MCP ou OpenAPI.

Documentação · OpenAPI · llms.txt · 中文

"Escreva uma música de aniversário calorosa para minha mãe que está fazendo 60 anos — ela adora cantar na cozinha."

→ 《Kitchen Radio》, 2 × 2:30 MP3, letra, capa. Uma chamada de ferramenta, um crédito.

Início rápido

Claude Desktop — adicione ao claude_desktop_config.json:

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

Claude Code / Cursor / qualquer coisa que fale com MCP remoto — sem instalação:

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

Cursor (um clique) — Adicionar ao Cursor na página de desenvolvedores, ou mcp.json neste repositório (login OAuth no primeiro uso).

Conectores claude.ai / ChatGPT — adicione a URL https://api.musicsforyou.com/mcp; o login OAuth já está integrado, sem necessidade de chave.

REST — uma chamada, música finalizada de volta:

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

Obtenha uma chave em https://www.musicsforyou.com/developers. Novas chaves vêm com 3 créditos grátis. A geração custa 1 crédito por chamada (você recebe duas versões); compilar e revisar são gratuitos.

Ferramentas

Ferramenta	Custo	O que faz
`create_song`	1 crédito	Uma chamada: para quem é a música → letra + duas versões completas + capa (o servidor espera até 180 s)
`compile_music_prompt`	grátis	Transforma um pedido em título / letra / estilo para o usuário ler primeiro
`revise_generation_prompt`	grátis	Aplica uma edição ("refrão mais forte", "voz feminina") a um plano
`generate_music`	1 crédito	Envia um plano; retorna um id de geração (duas versões)
`get_generation`	grátis	Consulta; suporta `waitSeconds` long-poll
`replace_section`	1 crédito	Refaz apenas uma parte de uma música finalizada
`separate_stems`	grátis uma vez por música	Separação vocal / instrumental (separação em 12 faixas precisa do Pro)
`list_tracks` `list_presets` `get_credit_balance` `get_purchase_link`	grátis	Biblioteca, cenas, saldo, link de checkout Stripe

O servidor também expõe prompts MCP (aniversário, casamento, intro de podcast…) e recursos (cartões de conhecimento de cena, detalhes de faixas).

Como funciona

Taoyuan não é um wrapper bruto de texto para música. Sua frase passa por um compilador de composição que decide estrutura, imagens e idioma, escreve letras seccionadas na segunda pessoa e escolhe um estilo; o resultado é gerado como dois candidatos completos com arte de capa. As letras são escritas a partir da história, nunca copiadas do prompt. Idiomas: chinês, cantonês, inglês, japonês.

Autenticação: chave de API (ty_live_…) ou OAuth 2.1 (PKCE, registro dinâmico de cliente) — https://api.musicsforyou.com/.well-known/oauth-authorization-server
Limites de taxa: 10 chamadas / min, 300 / dia por chave
Webhooks: PUT /v1/api-keys/:id/webhook → assinado com HMAC generation.finished
Preços: 10 músicas US$9,9 · 50 músicas US$39 (cartão, WeChat Pay, Alipay)

Exemplos

examples/claude_desktop_config.json
examples/openai-agents.py — OpenAI Agents SDK via MCP
examples/curl.sh — REST one-shot

Este pacote

taoyuan-mcp é um pequeno proxy stdio → Streamable HTTP (37 linhas). As definições de ferramentas ficam no servidor, então o pacote nunca fica desatualizado. Env: TAOYUAN_API_KEY (obrigatório), TAOYUAN_MCP_URL (override opcional).

Privacidade e termos

As músicas que você gera são suas para usar, inclusive comercialmente nos planos pagos. Termos · Privacidade · Suporte: 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，支持微信、支付宝、银行卡。

Licença: MIT