Taoyuan Music

Taoyuan MCP — ひとりのための歌を作る

その歌を誰に贈るのかをAIアシスタントに伝えます。1分ほどで、歌詞、2つのフルバージョン、カバーアートが完成します。
Claude Desktop、Claude Code、ChatGPT、Cursor、Coze、およびMCPやOpenAPIに対応するすべてのクライアントで動作します。

ドキュメント · OpenAPI · llms.txt · 中文

---

「60歳になる母のために、温かい誕生日の歌を書いてください。母はキッチンで歌うのが大好きです。」

→ 『Kitchen Radio』、2 × 2:30のMP3、歌詞、カバー。ツールを1回呼び出すだけで、クレジットを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 connectors / ChatGPT — URL https://api.musicsforyou.com/mcp を追加します。OAuthサインインが組み込まれているため、キーは不要です。

REST — 1回の呼び出しで、完成した曲が返されます：

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回につきクレジットを1つ消費します（2つのバージョンを取得できます）。コンパイルと修正は無料です。

ツール

ツール	コスト	内容
create_song	クレジット1つ	1回の呼び出しで、歌を贈る相手から歌詞＋2つのフルバージョン＋カバーまで生成します（サーバーは最大180秒待機します）
compile_music_prompt	無料	リクエストをタイトル／歌詞／スタイルに変換し、ユーザーが事前に確認できるようにします
revise_generation_prompt	無料	プランに編集（「サビをもっと力強く」「女性の声」など）を適用します
generate_music	クレジット1つ	プランを送信し、生成IDを返します（2つのバージョン）
get_generation	無料	生成状況を確認します。waitSeconds によるロングポーリングに対応しています
replace_section	クレジット1つ	完成した曲の一部分だけを作り直します
separate_stems	1曲につき1回無料	ボーカル／インストゥルメンタルを分離します（12ステムへの分離にはProが必要です）
list_tracks list_presets get_credit_balance get_purchase_link	無料	ライブラリ、シーン、残高、Stripeのチェックアウトリンク

このサーバーはMCPのプロンプト（誕生日、結婚式、ポッドキャストのイントロなど）とリソース（シーンのナレッジカード、トラックの詳細）も公開します。

仕組み

Taoyuanは、単なるテキストから音楽への変換ラッパーではありません。入力した文章は作詞コンパイラーを経由し、構成、イメージ、言語を決定して、二人称でセクション分けされた歌詞を書き、スタイルを選びます。その結果をもとに、カバーアート付きのフルバージョンを2つ生成します。歌詞はストーリーをもとに書かれ、プロンプトからコピーされることはありません。対応言語：中国語、広東語、英語、日本語。

• 認証：APIキー（ty_live_…）またはOAuth 2.1（PKCE、動的クライアント登録）— https://api.musicsforyou.com/.well-known/oauth-authorization-server
• レート制限：1キーあたり1分間に10回、1日あたり300回
• Webhook：PUT /v1/api-keys/:id/webhook → HMAC署名付きのgeneration.finished
• 料金：10曲 US$9.9 · 50曲 US$39（カード、WeChat Pay、Alipay）

使用例

• 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（任意の上書き設定）。

プライバシーと利用規約

生成した楽曲は有料プランでの商用利用を含め、ご自由にお使いいただけます。利用規約 · プライバシー · サポート：[email protected]

---

中国語

桃源 MCP：一人のために一曲を。 Claude、ChatGPT、Cursor、扣子で「母の60歳の誕生日に曲を書いて」と伝えるだけで、1分ほどで歌詞、完成版2曲、ジャケットが手に入ります。

• 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クレジットを消費します（2バージョン）。コンパイルと修正は無料です。クレジットパック：10回 US$9.9、50回 US$39、100回 ¥300。WeChat Pay、Alipay、銀行カードに対応しています。

ライセンス：MIT