MCP MiniMax Music Server

MCP MiniMax Music Server

MiniMax Music API を使用した、AI による音声生成向け Model Context Protocol（MCP）サーバーの実装です。Falah.G.Salieh が開発しました。

📋 目次

• 概要
• 機能
• 前提条件
• インストール
• 設定
• 使用方法
• API リファレンス
• トラブルシューティング
• コントリビューション
• ライセンス
• 作者

🎯 概要

この MCP サーバーを使用すると、AI エージェントは Model Context Protocol を介して MiniMax Music API を利用し、音楽や音声コンテンツを生成できます。Claude Desktop などの MCP ホストとシームレスに連携し、AI エージェントがテキストプロンプトに基づいて音楽や音声を作成できるようにします。

✨ 機能

• AI による音楽生成
• MiniMax Music モデルに対応
• ステータス確認を含む 2 段階の生成プロセス
• Claude Desktop とシームレスに連携
• API キー用の環境変数に対応
• 詳細なエラー処理とレポート

🔧 前提条件

• Node.js（v16 以上）
• TypeScript（v5.3.3 以上）
• Claude Desktop（最新バージョン）
• AIML API キー
• Windows／Linux／macOS オペレーティングシステム

📦 インストール

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/mcp-minimax-music-server.git
   cd mcp-minimax-music-server
   

2. 依存関係をインストールします：

   npm install
   

3. サーバーをビルドします：

   npm run build
   

⚙️ 設定

Claude Desktop の設定

1. Claude Desktop の設定ファイルを探します：

   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json

2. 次の設定を追加します：

   {
     "mcpServers": {
       "minimax-music-server": {
         "command": "node",
         "args": [
           "G:\\mcp-minimax-music-server\\build\\index.js"
         ],
         "env": {
           "AIML_API_KEY": "Bearer your-aiml-api-key-here"
         }
       }
     }
   }
   

   ⚠️ 重要：

   • パスを実際のサーバーパスに置き換えてください
   • API キーの前に「Bearer 」を付けてください
   • Windows のパスではバックスラッシュを 2 つ使用してください

API キーの設定

AIML API キーは 2 つの方法で設定できます：

1. 環境変数（推奨）

   • 上記のとおり、Claude Desktop の設定に追加します
   • 「Bearer 」（スペースを含む）を先頭に付けます
   • 例："AIML_API_KEY": "Bearer 3d90d64a000c4e6eb02df7e52d2166d2"

2. 直接設定

   • API キーを生成リクエストに直接渡します
   • 安全性は低くなりますが、テストに便利です

🚀 使用方法

基本的な使用方法

このサーバーは、次のパラメーターを持つ generate_audio というツールを提供します：

• prompt（必須）：音声生成用のテキストプロンプト
• model（任意）：「minimax-music」に設定します
• reference_audio_url（任意）：参照音声の URL
• generation_id（任意）：ステータス確認用の、前回の生成 ID

コマンドの例

1. 新しい生成を開始します：

   Generate audio with prompt "Create a romantic love song with gentle acoustic guitar and soft vocals"
   

2. 生成ステータスを確認します：

   Generate audio with generation_id "abc123" and prompt "Check status"
   

レスポンス形式

{
  "toolResult": {
    "status": "completed",
    "id": "generation-id",
    "audio_file": {
      "url": "https://cdn.example.com/audio.mp3",
      "content_type": "audio/mpeg",
      "file_name": "output.mp3",
      "file_size": 1024000
    }
  }
}

📚 API リファレンス

MiniMax Music モデル

このサーバーは次の特徴を持つ MiniMax Music モデルを使用します：

• 音楽生成に特化しています
• スタイルを一致させるには参照音声が必要です

• 区切り文字を使った歌詞の生成に対応しています

• 高品質な音楽を生成します

生成プロセス

1. ステップ 1：生成を送信

   • プロンプトとパラメーターを送信します
   • 生成 ID を受け取ります

2. ステップ 2：ステータスを確認

   • 生成 ID を使ってステータスをポーリングします
   • 完了したら音声をダウンロードします

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

よくある問題

1. 認証エラー（401）

   • API キーの形式を確認します（「Bearer 」で始まる必要があります）
   • API キーが有効か確認します
   • claude_desktop_config.json の設定が正しいことを確認します

2. パスの問題

   • OS に適したパス形式を使用します
   • Windows：バックスラッシュを 2 つ使用します
   • ビルドディレクトリが存在することを確認します

3. 生成エラー

   • プロンプトの形式を確認します（歌詞の場合は ##...## で囲む必要があります）
   • 参照音声 URL にアクセスできることを確認します
   • プロンプトの長さと内容を確認します

デバッグ手順

1. サーバーを再ビルドします：

   npm run build
   

2. Claude Desktop を再起動します

3. サーバーのログでエラーを確認します

🤝 コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. プルリクエストを作成します

📄 ライセンス

MIT License の詳細については、LICENSE ファイルをご覧ください

👤 作者

Falah.G.Salieh

• 所在地：イラク、バグダッド
• 役割：開発者兼 AI インテグレーションスペシャリスト
• 年：2025

🌟 サポート

お困りですか？サポートを受ける方法は次のとおりです：

1. トラブルシューティングのセクションを確認します
2. リポジトリでイシューを作成します
3. 作者に直接連絡します

---

このプロジェクトは Model Context Protocol エコシステムの一部であり、AI エージェントと外部サービスのシームレスな連携を実現します。