MCP MiniMax Music Server

🚀 MCP Minimized Music Server

A Model Context Protocol (MCP) server implemented through the Minimax Music API for AI-driven audio generation, developed by Falah.G.Salieh.

🚀 Quick Start

The MCP Minimized Music Server is a project implemented via the Model Context Protocol (MCP), enabling seamless integration of AI agents with external services. It aims to leverage the powerful capabilities of the Minimax Music API to generate high-quality music content.

✨ Features

• AI-driven Audio Generation: Generate music using AI algorithms.
• High-precision Output: Support high-resolution audio formats.
• Multi-platform Compatibility: Suitable for Windows, Linux, and macOS.
• Flexible Configuration: Support custom parameter settings.

📦 Installation

Prerequisites

To run this project, you need the following prerequisites:

1. Node.js (version 8 or higher).
2. TypeScript (optional but recommended).
3. Claude Desktop (for integrating and managing AI agents).
4. API Key: Necessary credentials to access the Minimax Music API.

Steps

1. Clone the repository:

git clone [repository URL]

2. Navigate to the project directory:

cd mcp-minimax-music-server

3. Install dependencies:

npm install

4. Build the project:

npm run build

📚 Documentation

Configuration

1. Environment Variables: Create a .env file in the project's root directory and add the following content:

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

2. Claude Desktop Configuration:
   • Open Claude Desktop.
   • Navigate to "Settings" > "Integration".
   • Add the MCP Minimized Music Server plugin.

Usage

1. Submit a generation request:

node generate.js --prompt "your_music_prompt_here"

2. Check the status:

node status.js --id your_generation_id

API Reference

Model Overview

• Minimax Music Model: Support lyric generation, audio synthesis, and high-precision output.
• Format: Support JSON input/output.

Generation Process

1. Step 1: Submit a request
   • Send prompts and parameters.
   • Receive a generation ID.
2. Step 2: Check the status
   • Query the progress using the generation ID.
   • Download the completed audio file.

Troubleshooting

Common Issues

1. Authentication Error (401):
   • Confirm that the API key format is correct (should start with "Bearer").
   • Check the validity of the key.
2. Path Issues:
   • Use the correct path format (Windows: double backslashes; Linux/macOS: single slashes).
3. Generation Errors:
   • Confirm that the prompt format is correct (should use the ## separator).

Debugging Steps

1. Rebuild the project:

npm run build

2. Restart Claude Desktop.
3. Check the server logs.

Contribution Guidelines

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Falah.G.Salieh

• Location: Baghdad, Iraq
• Position: Developer & AI Integration Expert
• Year: 2025

Support

Need help? Follow these steps to get support:

1. Check the troubleshooting section.
2. Open an issue in the repository.
3. Contact the author directly.