AI-powered audio generation using the MiniMax Music API.
A Model Context Protocol (MCP) server implementation for AI-powered audio generation using the MiniMax Music API. Developed by Falah.G.Salieh.
This MCP server enables AI agents to generate music and audio content using the MiniMax Music API through the Model Context Protocol. It provides seamless integration with MCP hosts like Claude Desktop, allowing AI agents to create music and audio based on text prompts.
Clone the repository:
git clone https://github.com/yourusername/mcp-minimax-music-server.git
cd mcp-minimax-music-server
Install dependencies:
npm install
Build the server:
npm run build
Locate your Claude Desktop configuration file:
%APPDATA%\Claude\claude_desktop_config.json
~/.config/Claude/claude_desktop_config.json
~/Library/Application Support/Claude/claude_desktop_config.json
Add the following configuration:
{
"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"
}
}
}
}
⚠️ Important:
- Replace the path with your actual server path
- Add "Bearer " prefix to your API key
- Use double backslashes in Windows paths
Your AIML API key can be configured in two ways:
Environment Variables (Recommended)
"AIML_API_KEY": "Bearer 3d90d64a000c4e6eb02df7e52d2166d2"
Direct Configuration
The server provides a tool called generate_audio
with the following parameters:
prompt
(required): Text prompt for audio generationmodel
(optional): Set to "minimax-music"reference_audio_url
(optional): URL of reference audiogeneration_id
(optional): ID from previous generation for status checkingStart new generation:
Generate audio with prompt "Create a romantic love song with gentle acoustic guitar and soft vocals"
Check generation status:
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
}
}
}
The server uses the MiniMax Music model which:
Step 1: Submit Generation
Step 2: Check Status
Authentication Errors (401)
claude_desktop_config.json
Path Issues
Generation Errors
Rebuild the server:
npm run build
Restart Claude Desktop
Check server logs for errors
MIT License - see the LICENSE file for details
Falah.G.Salieh
Need help? Here's how to get support:
This project is part of the Model Context Protocol ecosystem, enabling seamless integration between AI agents and external services.
Analyze large codebases and document collections using high-context models via OpenRouter, OpenAI, or Google AI -- very useful, e.g., with Claude Code
Empowers LLMs with real-time network traffic analysis using tshark. Requires Wireshark's tshark to be installed.
integration that connects BloodHound with AI through MCP, allowing security professionals to analyze Active Directory attack paths using natural language queries instead of Cypher.
Extracts text and performs OCR on various documents like IDs and invoices, with support for Markdown conversion.
An example of a remote MCP server for Odoo, deployable on Cloudflare Workers without authentication.
Execute shell commands with structured output via a powerful CLI server.
Interacting with Phabricator API
MCP Server to control and interact with Unity3d Game Engine for game development
Monitors shadow-cljs builds and provides real-time build status updates.
Control CAD software with natural language instructions to perform drawing operations.