<div align="center">

MusicMCP.AI MCP Server

AI-Powered Music Generation with Model Context Protocol

Official MusicMCP.AI Model Context Protocol (MCP) server that enables seamless interaction with our advanced AI music generation platform. This server allows MCP clients like Claude Desktop, OpenAI Agents and others to generate AI music through natural language commands.

</div>

Features

• ** AI Music Generation**: Generate songs based on text prompts using MusicMCP.AI's state-of-the-art AI models
• ** Dual Generation Modes**: Support for both inspiration mode and custom mode
• ** Direct Download Links**: Get direct download URLs for generated music
• ** Instrumental Options**: Generate instrumental-only music or full songs with vocals
• ** Credit Balance Check**: Check your API key validity and remaining credits
• ** Health Monitoring**: Check API service health status

Quickstart with Claude Desktop

1. Get Your API Key: Obtain your API key from MusicMCP.AI Platform
2. Install uv: Install the Python package manager with curl -LsSf https://astral.sh/uv/install.sh | sh
3. Configure Claude: Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json and add:

{
    "mcpServers": {
        "MusicMCP.AI": {
            "command": "uvx",
            "args": [
                "aimusic-mcp"
            ],
            "env": {
                "MUSICMCP_API_KEY": "<insert-your-api-key-here>",
                "MUSICMCP_API_URL": "https://www.musicmcp.ai/api",
                "TIME_OUT_SECONDS": "600"
            }
        }
    }
}

1. Restart Claude: Restart the Claude app and you'll see 4 MCP tools available, indicating successful loading

Environment Variables

Available Tools

1. Generate Prompt Song (Inspiration Mode)

Generate AI music based on simple text descriptions. AI automatically creates title, lyrics, and style.

Cost: 5 credits per generation (creates 2 songs)

Parameters:

• prompt (str): Simple description of the music theme (1-1200 characters)
• instrumental (bool): Whether to generate instrumental music only
• style (str, optional): Music style (e.g., "ambient", "pop", "rock")

Example Prompts:

"Help me generate a song about a peaceful morning"
"Want a song that expresses longing"
"Create music about friendship"

Output Example:

 Song 1 generated successfully!

 Title: Peaceful Morning
 ID: c7630638-b8ba-4984-876b-6dd7e6eeb796
 Download URL: https://cdn.musicmcp.ai/songs/abc123.mp3
  Cover Image: https://cdn.musicmcp.ai/images/abc123.jpg
  Duration: 180s
 Style Tags: ambient, meditation, peaceful
 Instrumental: No
 Created: 2025-01-15T10:30:45.123Z
 Lyrics:
[Verse]
Gentle sunlight fills the room
Morning dew and sweet perfume
Birds are singing their refrain
Another peaceful day again

You can download or play the audio from the URL above.

 Song 2 generated successfully!

 Title: Morning Peace
 ID: d8741749-c9cb-5095-987c-7ee8f7ffb907
 Download URL: https://cdn.musicmcp.ai/songs/def456.mp3
  Cover Image: https://cdn.musicmcp.ai/images/def456.jpg
  Duration: 213s
 Style Tags: ambient, meditation, peaceful
 Instrumental: No
 Created: 2025-01-15T10:30:45.126Z
 Lyrics:
[Verse]
Calm and quiet, soft and still
Peaceful thoughts upon the hill
Nature's beauty all around
Gentle whispers, soothing sound

You can download or play the audio from the URL above.

2. Generate Custom Song (Custom Mode)

Generate AI music with specific lyrics, title, and style parameters that you provide.

Cost: 5 credits per generation (creates 2 songs)

Parameters:

• title (str): Song title (required)
• instrumental (bool): Whether to generate instrumental music only (required)
• lyric (str, optional): Complete lyrics content (not required when instrumental is true)
• tags (str, optional): Music style tags (e.g., 'pop', 'rock', 'folk')

Example Usage:

Please help me generate a song:
Title: Summer Dreams
Lyrics: [complete lyrics content]
Style: folk

Or for instrumental:
Title: Summer Breeze
Instrumental: yes
Style: ambient

Output Example:

 Custom song 'Summer Dreams' (version 1) generated successfully!

 Title: Summer Dreams
 ID: d1ed75a7-3e0b-42c6-b2be-7631204074fe
 Download URL: https://cdn.musicmcp.ai/songs/xyz789.mp3
 Cover Image: https://cdn.musicmcp.ai/images/xyz789.jpg
 Duration: 195s
 Style Tags: folk, acoustic, summer
 Instrumental: No
 Created: 2025-01-15T11:45:30.456Z
 Lyrics:
[Verse]
Walking through the summer fields
Golden wheat and nature's yields
Sunshine dancing on my face
Summer's warm and sweet embrace

You can download or play the audio from the URL above.

 Custom song 'Summer Dreams' (version 2) generated successfully!

 Title: Summer Dreams
 ID: e2fe86b8-4f1c-53d7-c3cf-8742305185gf
 Download URL: https://cdn.musicmcp.ai/songs/uvw012.mp3
 Cover Image: https://cdn.musicmcp.ai/images/uvw012.jpg
 Duration: 203s
 Style Tags: folk, acoustic, summer
 Instrumental: No
 Created: 2025-01-15T11:45:30.459Z
 Lyrics:
[Verse]
Walking through the summer fields
Golden wheat and nature's yields
Sunshine dancing on my face
Summer's warm and sweet embrace

You can download or play the audio from the URL above.

3. Check Credit Balance

Check if your API key is valid and see your remaining credits.

Cost: Free

Example Usage:

"Check my credit balance"
"How many credits do I have left?"

4. Check API Health

Monitor the health status of the MusicMCP.AI API service.

Cost: Free

**Ex…