MCP MiniMax Music Server

🚀 MCP最小化音楽サーバー

最小化最大化音楽APIを通じて実現された、AI駆動の音声生成用のモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

MCP最小化音楽サーバーは、モデルコンテキストプロトコル（MCP）を通じて、AIエージェントと外部サービスをシームレスに統合することができるプロジェクトです。最小化最大化音楽APIの強力な機能を活用し、高品質な音楽コンテンツを生成することを目的としています。

✨ 主な機能

• AI駆動の音声生成：AIアルゴリズムを使用して音楽を生成します。
• 高精度出力：高解像度の音声形式をサポートします。
• 多プラットフォーム互換性：Windows、Linux、macOSに対応しています。
• 柔軟な設定：カスタムパラメータの設定をサポートしています。

📦 インストール

前提条件

このプロジェクトを実行するには、以下の前提条件が必要です。

1. Node.js（バージョン8以上）
2. TypeScript（オプションですが、推奨）
3. Claude Desktop（AIエージェントの統合と管理に使用）
4. APIキー：最小化最大化音楽APIにアクセスするための必須の資格情報

インストール手順

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

   git clone [リポジトリのURL]
   

2. プロジェクトディレクトリに移動します。

   cd mcp-minimax-music-server
   

3. 依存関係をインストールします。

   npm install
   

4. プロジェクトをビルドします。

   npm run build
   

💻 使用例

基本的な使用法

生成リクエストの送信

node generate.js --prompt "your_music_prompt_here"

ステータスの確認

node status.js --id your_generation_id

📚 ドキュメント

設定

環境変数

プロジェクトのルートディレクトリに.envファイルを作成し、以下の内容を追加します。

API_KEY=your_api_key_here
CLAude_PATH="/path/to/claude/desktop"

Claude Desktopの設定

• Claude Desktopを開きます。
• 「設定」>「統合」を選択します。
• MCP最小化音楽サーバープラグインを追加します。

APIリファレンス

モデルの概要

• 最小化最大化音楽モデル：歌詞生成、音声合成、高精度出力をサポートしています。
• 形式：JSON入力/出力をサポートしています。

生成フロー

1. ステップ1：リクエストの送信
   • プロンプトとパラメータを送信します。
   • 生成IDを受け取ります。
2. ステップ2：ステータスの確認
   • 生成IDを使用して進捗状況を照会します。
   • 完了した音声ファイルをダウンロードします。

トラブルシューティング

一般的な問題

1. 認証エラー（401）
   • APIキーの形式が正しいことを確認してください（「Bearer」で始まる必要があります）。
   • キーの有効性を確認してください。
2. パスの問題
   • 正しいパス形式を使用してください（Windows：ダブルバックスラッシュ；Linux/macOS：シングルスラッシュ）。
3. 生成エラー
   • プロンプトの形式が正しいことを確認してください（##区切り文字を使用する必要があります）。

デバッグ手順

1. プロジェクトを再構築します。

   npm run build
   

2. Claude Desktopを再起動します。
3. サーバーログを確認します。

貢献ガイド

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

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細についてはLICENSEファイルを参照してください。

作者

Falah.G.Salieh

• 所在地：イラク、バグダッド
• 職位：開発者 & AI統合エキスパート
• 年：2025

サポート

サポートが必要な場合は、以下の手順に従ってください。

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