
🎵 MusicMCP.AI MCP サーバー
Model Context Protocol を活用した AI 音楽生成
MusicMCP.AI 公式の Model Context Protocol(MCP)サーバーです。当社の高度な AI 音楽生成プラットフォームとシームレスに連携し、Claude Desktop、OpenAI Agents などの MCP クライアントから自然言語コマンドで AI 音楽を生成できます。
✨ 主な機能
- 🎼 AI 音楽生成: MusicMCP.AI の最先端 AI モデルを使い、テキストプロンプトから楽曲を生成
- 🎵 2 つの生成モード: インスピレーションモードとカスタムモードに対応
- 🔗 直接ダウンロードリンク: 生成した音楽の直接ダウンロード URL を取得
- 🎹 インストゥルメンタル対応: インストゥルメンタルのみ、またはボーカル付きのフル楽曲を生成
- ✅ クレジット残高確認: API キーの有効性と残りクレジットを確認
- 🏥 ヘルスモニタリング: API サービスのヘルスステータスを確認
🚀 Claude Desktop でのクイックスタート
- API キーを取得: MusicMCP.AI Platform から API キーを取得します
- uv をインストール:
curl -LsSf https://astral.sh/uv/install.sh | sh で Python パッケージマネージャーをインストールします
- Claude を設定: Claude > Settings > Developer > Edit Config > claude_desktop_config.json を開き、以下を追加します:
{
"mcpServers": {
"MusicMCP.AI": {
"command": "uvx",
"args": [
"aimusic-mcp"
],
"env": {
"MUSICMCP_API_KEY": "<insert-your-api-key-here>",
"MUSICMCP_API_URL": "https://www.musicmcp.ai/api",
"TIME_OUT_SECONDS": "600"
}
}
}
}
- Claude を再起動: Claude アプリを再起動すると、4 つの MCP ツール が利用可能になり、読み込み成功を確認できます
⚙️ 環境変数
| 変数 |
説明 |
デフォルト |
必須 |
MUSICMCP_API_KEY |
MusicMCP.AI API キー |
- |
✅ はい |
MUSICMCP_API_URL |
MusicMCP.AI API ベース URL |
https://www.musicmcp.ai/api |
❌ いいえ |
TIME_OUT_SECONDS |
音楽生成のタイムアウト秒数 |
600(10 分) |
❌ いいえ |
🛠️ 利用可能なツール
1. 🎼 Generate Prompt Song(インスピレーションモード)
簡単なテキスト説明から AI 音楽を生成します。AI がタイトル、歌詞、スタイルを自動的に作成します。
コスト: 1 回の生成につき 5 クレジット(2 曲を作成)
パラメータ:
prompt (str): 音楽テーマの簡単な説明(1〜1200 文字)
instrumental (bool): インストゥルメンタルのみを生成するかどうか
style (str, optional): 音楽スタイル(例: "ambient", "pop", "rock")
プロンプト例:
"平和な朝についての曲を生成して"
"切なさを表現する曲が欲しい"
"友情についての音楽を作成して"
出力例:
✅ Song 1 generated successfully!
📌 Title: Peaceful Morning
🆔 ID: c7630638-b8ba-4984-876b-6dd7e6eeb796
🔗 Download URL: https://cdn.musicmcp.ai/songs/abc123.mp3
🖼️ Cover Image: https://cdn.musicmcp.ai/images/abc123.jpg
⏱️ Duration: 180s
🎵 Style Tags: ambient, meditation, peaceful
🎹 Instrumental: No
📅 Created: 2025-01-15T10:30:45.123Z
📝 Lyrics:
[Verse]
Gentle sunlight fills the room
Morning dew and sweet perfume
Birds are singing their refrain
Another peaceful day again
You can download or play the audio from the URL above.
✅ Song 2 generated successfully!
📌 Title: Morning Peace
🆔 ID: d8741749-c9cb-5095-987c-7ee8f7ffb907
🔗 Download URL: https://cdn.musicmcp.ai/songs/def456.mp3
🖼️ Cover Image: https://cdn.musicmcp.ai/images/def456.jpg
⏱️ Duration: 213s
🎵 Style Tags: ambient, meditation, peaceful
🎹 Instrumental: No
📅 Created: 2025-01-15T10:30:45.126Z
📝 Lyrics:
[Verse]
Calm and quiet, soft and still
Peaceful thoughts upon the hill
Nature's beauty all around
Gentle whispers, soothing sound
You can download or play the audio from the URL above.
2. 🎵 Generate Custom Song(カスタムモード)
指定した歌詞、タイトル、スタイルパラメータで AI 音楽を生成します。
コスト: 1 回の生成につき 5 クレジット(2 曲を作成)
パラメータ:
title (str): 楽曲タイトル(必須)
instrumental (bool): インストゥルメンタルのみを生成するかどうか(必須)
lyric (str, optional): 完全な歌詞内容(instrumental が true の場合は不要)
tags (str, optional): 音楽スタイルタグ(例: 'pop', 'rock', 'folk')
使用例:
曲を生成してください:
タイトル: Summer Dreams
歌詞: [完全な歌詞内容]
スタイル: folk
またはインストゥルメンタルの場合:
タイトル: Summer Breeze
インストゥルメンタル: yes
スタイル: ambient
出力例:
✅ Custom song 'Summer Dreams' (version 1) generated successfully!
📌 Title: Summer Dreams
🆔 ID: d1ed75a7-3e0b-42c6-b2be-7631204074fe
🔗 Download URL: https://cdn.musicmcp.ai/songs/xyz789.mp3
🖼️ Cover Image: https://cdn.musicmcp.ai/images/xyz789.jpg
⏱️ Duration: 195s
🎵 Style Tags: folk, acoustic, summer
🎹 Instrumental: No
📅 Created: 2025-01-15T11:45:30.456Z
📝 Lyrics:
[Verse]
Walking through the summer fields
Golden wheat and nature's yields
Sunshine dancing on my face
Summer's warm and sweet embrace
You can download or play the audio from the URL above.
✅ Custom song 'Summer Dreams' (version 2) generated successfully!
📌 Title: Summer Dreams
🆔 ID: e2fe86b8-4f1c-53d7-c3cf-8742305185gf
🔗 Download URL: https://cdn.musicmcp.ai/songs/uvw012.mp3
🖼️ Cover Image: https://cdn.musicmcp.ai/images/uvw012.jpg
⏱️ Duration: 203s
🎵 Style Tags: folk, acoustic, summer
🎹 Instrumental: No
📅 Created: 2025-01-15T11:45:30.459Z
📝 Lyrics:
[Verse]
Walking through the summer fields
Golden wheat and nature's yields
Sunshine dancing on my face
Summer's warm and sweet embrace
You can download or play the audio from the URL above.
3. ✅ クレジット残高を確認
API キーが有効かどうかと、残りのクレジットを確認します。
コスト: 無料
使用例:
"クレジット残高を確認して"
"残りクレジットはいくつ?"
4. 🏥 API ヘルスチェック
MusicMCP.AI API サービスのヘルスステータスを監視します。
コスト: 無料
使用例:
"API サービスのステータスを確認して"
💰 クレジットと料金
| 操作 |
クレジット消費 |
出力 |
| インスピレーション楽曲を生成 |
5 クレジット |
2 曲 |
| カスタム楽曲を生成 |
5 クレジット |
2 曲 |
| 楽曲ステータスを照会 |
0 クレジット(無料) |
- |
| クレジット残高を確認 |
0 クレジット(無料) |
- |
| API ヘルスチェック |
0 クレジット(無料) |
- |
💡 使用例
⚠️ 注意: MusicMCP.AI の音楽生成ツールを利用するにはクレジットが必要です。
Claude に次のように質問してみてください:
インスピレーションモード:
- "平和な朝についての曲を生成してください"
- "切なさを表現する曲が欲しい"
- "友情についての音楽を作成して"
- "アンビエント音楽トラックを生成して"
カスタムモード:
- "曲を生成してください。タイトル: Summer Dreams、歌詞: [完全な歌詞]、スタイル: folk"
- "曲を作成してください。タイトル: Spring Promise、歌詞: [完全な歌詞]、Pop スタイル"
- "インストゥルメンタル曲を生成してください。タイトル: Ocean Breeze、スタイル: ambient"
管理機能:
- "クレジット残高を確認して"
- "残りクレジットはいくつ?"
- "API サービスのステータスを確認して"
📦 インストール
uv を使用(推奨)
uvx aimusic-mcp
pip を使用
pip install aimusic-mcp
🔌 API 統合
この MCP サーバーは MusicMCP.AI の RESTful API と統合されています:
POST /music/generate/inspiration: 音楽生成タスクを作成(インスピレーションモード)
POST /music/generate/custom: カスタム音楽生成タスクを作成
POST /music/generate/query: 音楽ステータスを照会(バッチ照会対応)
GET /credit: クレジット残高を確認
GET /health: API サービスのヘルスを確認
🔄 非同期 API ワークフロー
音楽生成は非同期です。MCP サーバーがこれを自動的に処理します:
ステップ 1: 生成リクエストを送信
POST /music/generate/inspiration or /music/generate/custom
→ Returns: {"code": 200, "data": {"ids": ["id1", "id2"]}}
ステップ 2: 自動ポーリング(MCP が内部で処理)
POST /music/generate/query with {"ids": ["id1", "id2"]}
→ Polls every 2 seconds until status = 1 (completed)
→ Song status: 0 = Failed, 1 = Completed, 2 = In Progress
ステップ 3: 完全な楽曲情報を返却
Once all songs are completed, returns full details:
- songName, songUrl, imgUrl, duration, tags, etc.
舞台裏:
- ユーザーが
generate_prompt_song() または generate_custom_song() を呼び出します
- MCP が生成リクエストを送信 → 2 曲の ID を受信します
- MCP が
/music/generate/query を 2 秒ごとに自動ポーリングします
- すべての曲が完了(status=1)すると、ダウンロード URL を返します
- デフォルトタイムアウト: 10 分(
TIME_OUT_SECONDS で設定可能)
重要な注意:
- ⏱️ 生成には通常 1 曲あたり 2〜5 分かかります
- 🔁 ポーリングは MCP サーバーがすべて自動で処理します
- 🎵 各生成では常に 2 曲のバリエーションが作成されます
- 💰 生成リクエストが成功した時点で 5 クレジットが差し引かれます
- ⚠️ 生成に失敗した場合、クレジットは消費されません
🐛 トラブルシューティング
よくある問題
-
API キーエラー: MUSICMCP_API_KEY が正しく設定されていることを確認してください
check_credit_balance ツールでキーを確認できます
-
クレジット不足(402 エラー):