Mureka

What is Mureka?

Mureka is an AI-powered music generation tool that allows users to create lyrics, songs, and background music. The official MCP server enables interaction with lyrics, song, and background music (BGM) generation APIs, integrating with clients like Claude Desktop and OpenAI Agents to enhance creative workflows.

How to use Mureka?

Quickstart with Claude Desktop

1. Obtain an API key from Mureka.
2. Install uv (Python package manager) using the provided script or from the uv repo.
3. Configure claude_desktop_config.json by adding the Mureka MCP server details and your API key.
4. Restart the Claude app and use one of the available MCP tools (e.g., "create a song" or "generate lyrics").

Quickstart with OpenAI Agents SDK

1. Install the OpenAI Agents SDK (pip install openai-agents).
2. Run an example script (e.g., openapi_agents_example/main.py) with your Mureka API key.
3. Observe the music generation process in the console.

Key features of Mureka

• Lyrics Generation: AI-assisted lyrics creation for any topic or theme.
• Song Synthesis: Complete song generation from lyrics or themes.
• Background Music (BGM): Custom BGM generation for various settings (e.g., coffee shops).
• MCP Integration: Works with popular AI tools like Claude Desktop and OpenAI Agents.
• Customizable Timeout: Adjust response timeout via environment variables.

Use cases of Mureka

1. Personalized Songs: Create birthday songs, love ballads, or thematic compositions.
2. Professional Content: Generate background music for videos, podcasts, or live streams.
3. Creative Brainstorming: Use AI to generate lyrics or song ideas for artistic projects.
4. AI Tool Enhancement: Integrate with other AI platforms to expand creative capabilities.

FAQ about Mureka

• Are Mureka credits required?

  Yes, credits are needed for song and BGM generation. Obtain them via the Mureka platform.

• Which AI clients are compatible?

  Mureka integrates with MCP clients like Claude Desktop and OpenAI Agents. Check the GitHub repo for updates.

• Where are logs stored for troubleshooting?

  Logs are saved at:

  • Windows: %APPDATA%\Claude\logs\mcp-server-Mureka.log
  • macOS: ~/Library/Logs/Claude/mcp-server-Mureka.log
• How to adjust generation timeout?

  Set TIME_OUT_SECONDS in claude_desktop_config.json (default: 60s).

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

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

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

![Image 2](https://github.com/SkyworkAI/Mureka-mcp/blob/master/assets/demo.jpeg?raw=true)

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

![Image 3](https://github.com/SkyworkAI/Mureka-mcp/blob/master/assets/demo1.jpeg?raw=true)

 [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 

![Image 4](https://raw.githubusercontent.com/SkyworkAI/Mureka-mcp/refs/heads/master/assets/openai_1.jpeg)

![Image 5](https://raw.githubusercontent.com/SkyworkAI/Mureka-mcp/refs/heads/master/assets/openai_2.jpeg)