Quickstart with Claude Desktop

1. Get your API key from Mureka.
2. Install uv (Python package manager), install with curl -LsSf https://astral.sh/uv/install.sh | sh or see the uvrepo for additional install methods.
3. Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

{
    "mcpServers": {
        "Mureka": {
            "command": "uvx",
            "args": [
                "mureka-mcp"
            ],
            "env": {
                "MUREKA_API_KEY": "<insert-your-api-key-here>",
                "MUREKA_API_URL": "https://api.mureka.ai",
                "TIME_OUT_SECONDS":"300"
            }
        }
    }
}

Then restart the Claude app and see 4 MCP tools available in the window, indicating successful loading

Optional features

You can add the TIME_OUT_SECONDS environment variable to the claude_desktop_config.json to set the timeout period for song or bgm generation waiting(Default 60s).

Example usage

⚠️ Warning: Mureka credits are needed to use these tools. Try asking Claude:

• "Please create a song for my daughter Jessica to wish her a happy birthday and play it"

• "Please generate lyrics about Christmas"
• "Please generate a song based on the lyrics just now"
• "Please generate background music suitable for playing in the coffee shop"

bgm 1 download

bgm 2 download

Troubleshooting

Logs when running with Claude Desktop can be found at:

• Windows: %APPDATA%\Claude\logs\mcp-server-Mureka.log
• macOS: ~/Library/Logs/Claude/mcp-server-Mureka.log

Quickstart with Openai agents sdk

Install Agents SDK

pip install openai-agents

Run example: openapi_agents_example/main.py

Key is required to be filled in:

MUREKA_API_KEY = "<insert-your-api-key-here>"

After running, you can see the composition process in the console