Ai Music Mcp

✨ 特長

• 🎼 AI 音楽生成：MusicMCP.AI の最先端 AI モデルを使用し、テキストプロンプトに基づいて楽曲を生成します
• 🎵 2 種類の生成モード：インスピレーションモードとカスタムモードの両方に対応しています
• 🔗 直接ダウンロードリンク：生成した音楽の直接ダウンロード URL を取得できます
• 🎹 インストゥルメンタルのオプション：インストゥルメンタルのみの音楽、またはボーカル入りのフルソングを生成できます
• ✅ クレジット残高の確認：API キーの有効性と残りのクレジットを確認できます
• 🏥 ヘルスモニタリング：API サービスのヘルスステータスを確認できます

🚀 Claude Desktop でクイックスタート

1. API キーを取得する：MusicMCP.AI Platform から API キーを取得します
2. uv をインストールする：curl -LsSf https://astral.sh/uv/install.sh | sh を実行して、Python パッケージマネージャーをインストールします
3. 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"
            }
        }
    }
}

4. 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. 🎼 プロンプトから楽曲を生成（インスピレーションモード）

簡単なテキストによる説明に基づいて AI 音楽を生成します。AI がタイトル、歌詞、スタイルを自動で作成します。

料金：生成ごとに 5 クレジット（2 曲を生成）

パラメーター：

• prompt (str)：音楽のテーマを簡単に説明します（1～1200 文字）
• instrumental (bool)：インストゥルメンタルのみの音楽を生成するかどうか
• style (str, optional)：音楽のスタイル（例："ambient"、"pop"、"rock"）

プロンプトの例：

"Help me generate a song about a peaceful morning"
"Want a song that expresses longing"
"Create music about friendship"

出力例：

✅ 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. 🎵 カスタム楽曲を生成（カスタムモード）

指定した歌詞、タイトル、スタイルのパラメーターに基づいて AI 音楽を生成します。

料金：生成ごとに 5 クレジット（2 曲を生成）

パラメーター：

• title (str)：楽曲のタイトル（必須）
• instrumental (bool)：インストゥルメンタルのみの音楽を生成するかどうか（必須）
• lyric (str, optional)：歌詞全文（instrumental が true の場合は不要）
• tags (str, optional)：音楽スタイルのタグ（例：'pop'、'rock'、'folk'）

使用例：

Please help me generate a song:
Title: Summer Dreams
Lyrics: [complete lyrics content]
Style: folk

Or for instrumental:
Title: Summer Breeze
Instrumental: yes
Style: 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 キーが有効かどうかを確認し、残りのクレジットを確認します。

料金：無料

使用例：

"Check my credit balance"
"How many credits do I have left?"

4. 🏥 API のヘルスステータスを確認

MusicMCP.AI API サービスのヘルスステータスを監視します。

料金：無料

使用例：

"Check API service status"

💰 クレジットと料金

操作	クレジット料金	出力
インスピレーションモードで音楽を生成	5 クレジット	2 曲
カスタムモードで音楽を生成	5 クレジット	2 曲
音楽のステータスを照会	0 クレジット（無料）	-
クレジット残高を確認	0 クレジット（無料）	-
API ヘルスチェック	0 クレジット（無料）	-

💡 使用例

⚠️ 注：音楽生成ツールを使用するには、MusicMCP.AI のクレジットが必要です。

Claude に次のように尋ねてみましょう：

インスピレーションモード：

• 「穏やかな朝をテーマにした曲を作ってください」
• 「憧れを表現する曲が欲しいです」
• 「友情をテーマにした音楽を作ってください」
• 「アンビエントの音楽トラックを生成してください」

カスタムモード：

• 「曲の生成を手伝ってください。タイトル：Summer Dreams、歌詞：[歌詞全文]、スタイル：フォーク」
• 「曲を作成してください。タイトル：Spring Promise、歌詞：[歌詞全文]、ポップスタイル」
• 「インストゥルメンタル曲を生成してください。タイトル：Ocean Breeze、スタイル：アンビエント」

管理機能：

• 「クレジット残高を確認してください」
• 「クレジットはあといくつ残っていますか？」
• 「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.

内部処理：

1. ユーザーが generate_prompt_song() または generate_custom_song() を呼び出します
2. MCP が生成リクエストを送信し、2 つの楽曲 ID を受け取ります
3. MCP が /music/generate/query を 2 秒ごとに自動でポーリングします
4. すべての楽曲の生成が完了すると（status=1）、ダウンロード URL を返します
5. デフォルトのタイムアウトは 10 分です（TIME_OUT_SECONDS で設定可能）

重要な注意事項：

• ⏱️ 通常、1 曲の生成には 2～5 分かかります
• 🔁 ポーリングは MCP サーバーがすべて自動的に処理します
• 🎵 生成のたびに、必ず 2 種類の楽曲が作成されます
• 💰 生成リクエストが成功すると、クレジット（5）が差し引かれます
• ⚠️ 生成に失敗した場合、クレジットは消費されません

🐛 トラブルシューティング

よくある問題

1. API キーエラー：MUSICMCP_API_KEY が正しく設定されていることを確認してください

   • check_credit_balance ツールを使用してキーを確認してください

2. クレジット不足（402 エラー）：クレジットが不足しています

   • https://www.musicmcp.ai で残高を確認してください
   • アカウントにチャージしてください

3. タイムアウトエラー：音楽の生成に時間がかかる場合は、TIME_OUT_SECONDS の値を大きくしてください

ログ

Claude Desktop で実行している場合、ログは次の場所にあります。

• Windows：%APPDATA%\Claude\logs\mcp-server-MusicMCP.AI.log
• macOS：~/Library/Logs/Claude/mcp-server-MusicMCP.AI.log

🧪 開発

テストの実行

pytest tests/

ローカル開発

python -m musicmcp_ai_mcp.api

コード構成

musicmcp_ai_mcp/
├── __init__.py          # Package initialization
├── __main__.py          # CLI entry point
└── api.py               # Core MCP server implementation (430 lines)

🔗 リンク

• プラットフォーム：https://www.musicmcp.ai
• ドキュメント：https://www.musicmcp.ai/docs
• サポート：[email protected]

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

---