Mureka

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

python

81

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "skyworkai-mureka-mcp": {
      "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"
      }
    }
  }
}

You can run the Mureka MCP Server locally to generate lyrics, songs, and background music through MCP clients. This server exposes APIs for lyrics, song composition, and instrumental background music, enabling powerful creative workflows with compatible clients.

How to use

To use the server, start it locally and connect from your MCP client. The server runs as a local process and exposes endpoints via a standard MCP runtime, allowing you to generate lyrics, full songs, or background music by sending requests through your MCP client’s tools. You can configure your client to point at the local MCP runtime or to a remote MCP URL if you run the server elsewhere. Typical usage patterns include creating a lyric set for a song, composing a new track based on a mood or theme, or generating background music suitable for a cafe or presentation.

How to install

curl -LsSf https://astral.sh/uv/install.sh | sh

This installs uv, the Python package manager used to run MCP servers locally.

## Additional sections

Configuration and runtime start are provided as explicit config examples you can copy into your environment. The MCP server can be started via a local runner and requires an API key to access Mureka services. Use the following config to run the server locally in your environment.

{ "mcpServers": { "mureka_mcp": { "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" } } } }


To load and run the server, ensure you have `uv` installed, then start the MCP with the configuration shown above. The environment variables provide the authentication and endpoint information the server needs to communicate with Mureka services.

## Security and usage notes

Keep your API key secure. Do not share your `MUREKA_API_KEY` or embed it in client-side applications. Store keys in secure environment configurations and rotate them periodically. When running the server locally, restrict access to trusted clients and monitor logs for unusual activity.

If you prefer to run supplementary tooling from Python, you can install the Python package for agents and use the provided examples, ensuring you pass your API key correctly.

## Troubleshooting

If you encounter connection or timeout issues, verify that `MUREKA_API_KEY` and `MUREKA_API_URL` are correctly set in the environment and that the server has started without errors. Check logs produced by the MCP runtime for any authentication or network errors.

## Examples of capabilities

- Generate lyrics for a mood or event.

- Compose a complete song based on provided themes or lyrics.

- Generate background music suitable for a cafe setting or a specific scene.

## Available tools

### generate\_lyrics

Create lyrics for a given theme, mood, or event using the MCP server.

### generate\_song

Compose a full song with verses, chorus, and structure based on provided prompts.

### generate\_bgm

Produce background music tracks suitable for use in videos, cafes, or scenes.