概要
What is Ai Music Mcp?
Ai Music Mcp is a Model Context Protocol (MCP) server that integrates with the MusicMCP.AI platform, enabling AI music generation through natural language commands. It is designed for users of MCP clients like Claude Desktop and OpenAI Agents.
How to use Ai Music Mcp?
Obtain an API key from MusicMCP.AI, install uv, then configure the claude_desktop_config.json with the uvx aimusic-mcp command and required environment variables (MUSICMCP_API_KEY). After restarting Claude, four MCP tools become available for generating songs, checking credits, and monitoring API health.
Key features of Ai Music Mcp
- AI music generation from text prompts
- Dual modes: inspiration (auto lyrics) and custom (user-provided lyrics)
- Direct download URLs for generated songs
- Instrumental-only or full song with vocals
- Credit balance and API health checks
- Each generation produces 2 song variations
Use cases of Ai Music Mcp
- Generate background music for videos or podcasts
- Create custom songs with specific lyrics and style
- Quickly produce demo tracks for creative projects
- Check remaining API credits and service status
FAQ from Ai Music Mcp
What does Ai Music Mcp do that alternatives do not?
It provides a direct MCP interface for AI music generation, allowing MCP clients to generate songs via natural language, with automatic handling of async polling and dual song output per request.
What are the runtime requirements?
Requires uv (or pip) and a valid MusicMCP.AI API key. Environment variables include MUSICMCP_API_KEY (required), MUSICMCP_API_URL (optional, default https://www.musicmcp.ai/api), and TIME_OUT_SECONDS (optional, default 600).
Where does generated data live?
Generated songs are hosted on MusicMCP.AI's CDN (https://cdn.musicmcp.ai/). Download URLs and metadata are returned to the client; no local storage is described.
How many credits are used per generation?
Both inspiration and custom modes cost 5 credits per generation, which yields 2 songs. Credit balance and health checks are free.
Is music generation synchronous or asynchronous?
Music generation is asynchronous; the MCP server automatically polls the API every 2 seconds until the songs complete (typically 2–5 minutes). If generation fails, credits are not consumed.
