generate_audioLABSCO SUMMARY
Generation is two calls, and the key format trips people first.
Submitting and collecting are separate steps — the first returns an ID, the second returns the file — so plan for a wait rather than a single blocking call. The commonest failure is not the model: a 401 almost always means the API key was stored without its Bearer prefix, which the README calls out because the key looks perfectly valid without it.
What it is
A bridge to the MiniMax Music model through the AIML API. You describe the music you want, the server submits the job and returns a generation ID, then a second call with that ID reports status and hands back the finished audio file URL.
What you get
generate_audiotakes apromptdescribing the music you want- An optional
modelargument, set tominimax-music - An optional
reference_audio_urlfor style matching - An optional
generation_id— pass the ID from a previous run to check on it instead of starting a new one - The completed response carries the audio
url,content_type,file_nameandfile_size - Lyrics are written between
##delimiters in the prompt
Requirements
Node.js v16 or higher and TypeScript v5.3.3 or higher. An AIML API key is required, and its format matters: the value must carry the Bearer prefix, spelled "AIML_API_KEY": "Bearer your-aiml-api-key-here" in the client's env block. Published as mcp-minimax-music-server version 0.1.0; the documented path is clone, npm install, npm run build, then point your client at build/index.js. Windows paths in the config need double backslashes.
Setup effort
Build from source — git clone https://github.com/falahgs/mcp-minimax-music-server.git
USE CASES
01
Getting a backing track from a description
Describe mood, instruments and vocals in a sentence and receive an audio file rather than a recommendation.
02
Matching the style of something you already have
Point the request at a reference audio URL so the output follows it.
03
Setting your own lyrics to music
Wrap the lyric text in the delimiters the model expects and submit it as the prompt.
04
Picking a job back up later
Pass the generation ID from an earlier run to check whether it has finished and collect the file.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation. generate_audio starts a generation and, called again with the generation_id, returns status and the finished audio URL; there is no separate status tool.
Requires
- Node.js
- AIML_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/falahgs/mcp-minimax-music-server.git
cd mcp-minimax-music-server
npm install
npm run buildAdd the mcpServers block to claude_desktop_config.json pointing args at your build/index.js and setting AIML_API_KEY
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"minimax-music-server": {
"command": "node",
"args": [
"G:\\mcp-minimax-music-server\\build\\index.js"
],
"env": {
"AIML_API_KEY": "Bearer <YOUR_AIML_API_KEY>"
}
}
}
}
