https://github.com/skyworkai/mureka-mcp

generate lyrics, song and background music(instrumental). Model Context Protocol (MCP) server.
https://github.com/skyworkai/mureka-mcp

Last synced: 4 months ago
JSON representation

generate lyrics, song and background music(instrumental). Model Context Protocol (MCP) server.

• Host: GitHub
• URL: https://github.com/skyworkai/mureka-mcp
• Owner: SkyworkAI
• License: mit
• Created: 2025-04-28T07:28:09.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2025-05-13T10:25:27.000Z (about 1 year ago)
• Last Synced: 2025-12-21T18:00:36.371Z (5 months ago)
• Language: Python
• Size: 12.1 MB
• Stars: 66
• Watchers: 2
• Forks: 13
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• toolsdk-mcp-registry - ❌ mureka-mcp - demand creation of lyrics, complete songs, and instrumental tracks without requiring specialized music production knowledge. (python) (Art & Culture / How to Submit)

README

          




![export](https://raw.githubusercontent.com/SkyworkAI/Mureka-mcp/refs/heads/master/assets/mureka_mcp.png)

[![Discord Community](https://raw.githubusercontent.com/SkyworkAI/Mureka-mcp/refs/heads/master/assets/discord_mureka.svg)](https://discord.com/invite/nwu9ANqAf5)

[![Twitter](https://raw.githubusercontent.com/SkyworkAI/Mureka-mcp/refs/heads/master/assets/x_mureka.svg)](https://x.com/Mureka_AI)

[![PyPI](https://raw.githubusercontent.com/SkyworkAI/Mureka-mcp/refs/heads/master/assets/pypi_mureka.svg)](https://pypi.org/project/mureka-mcp)





  Official Mureka Model Context Protocol (MCP) server that enables interaction with powerful lyrics, song and bgm generating APIs. This server allows MCP clients like Claude Desktop, OpenAI Agents and others to generate lyrics, song and background music(instrumental).



## Quickstart with Claude Desktop

1. Get your API key from [Mureka](https://platform.mureka.ai/apiKeys).

2. Install `uv` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh | sh` or see the `uv` [repo](https://github.com/astral-sh/uv) 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": "",

                "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](https://github.com/SkyworkAI/Mureka-mcp/raw/407ad955ab29c61e81b5d374e492ef8b1353c2f3/assets/16567807049729-9pi6MDiVqTavVUdjf54fmW.mp3)

[bgm 2 download](https://github.com/SkyworkAI/Mureka-mcp/raw/407ad955ab29c61e81b5d374e492ef8b1353c2f3/assets/16567807049729-D7WVCcxp77Prm8b15HSX1G.mp3)

## 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 = ""

```

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