Skip to main content

export

Discord Community Twitter PyPI

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

Metadata

Release files for iflow-mcp_skyworkai-mureka-mcp 0.0.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_skyworkai-mureka-mcp 0.0.13
File Size Uploaded
iflow_mcp_skyworkai_mureka_mcp-0.0.13.tar.gz 7.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_skyworkai-mureka-mcp 0.0.13
File Interpreter ABI Platform
iflow_mcp_skyworkai_mureka_mcp-0.0.13-py3-none-any.whl Python 3 none any Details

Total release size: 16.1 kB

Release files / iflow_mcp_skyworkai_mureka_mcp-0.0.13.tar.gz

Download URL iflow_mcp_skyworkai_mureka_mcp-0.0.13.tar.gz
Size 7.9 kB
Tags Source
SHA-256 checksum
How to use checksums
31a2e4f704bc95ccad8062d366ce3af3551335b28e3919faed3f55c98f55c384
BLAKE2b-256 checksum
How to use checksums
66413f373fbf2bac62944fed3b07a9c06f4666985f9a58c827f19404a22a96f5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_skyworkai_mureka_mcp-0.0.13-py3-none-any.whl

Download URL iflow_mcp_skyworkai_mureka_mcp-0.0.13-py3-none-any.whl
Size 8.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f532a6e5e1c83bf58adc7143894a49b0061c03fef9cf9f9b7071e21a12e8033d
BLAKE2b-256 checksum
How to use checksums
42efedd29e9aab70927ca772ac83a22ca65404299704fbb1d55ebfb5a29f4615
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.0.13 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page