MCP 服务器概览
<div class=“title-block” style=“text-align: center;” align=“center”>

</div> <p align=“center”> Official Mureka Model Context Protocol (MCP) server that enables interaction with powerful lyrics, song and bgm generating APIs. This server allows MCP clients like <a href=“https://www.anthropic.com/claude”>Claude Desktop</a>, <a href=“https://github.com/openai/openai-agents-python”>OpenAI Agents</a> and others to generate lyrics, song and background music(instrumental). </p>
Quickstart with Claude Desktop
- Get your API key from Mureka.
- Install
uv(Python package manager), install withcurl -LsSf https://astral.sh/uv/install.sh | shor see theuvrepo for additional install methods. - 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 <div class=“title-block” style=“text-align: left;”> <img src=“https://raw.githubusercontent.com/SkyworkAI/Mureka-mcp/refs/heads/master/assets/img.png” width=“400”> </div>
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” <div class=“title-block” style=“text-align: left;”> <img src=“https://github.com/SkyworkAI/Mureka-mcp/blob/master/assets/demo.jpeg?raw=true” width=“400”> </div>
-
“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” <div class=“title-block” style=“text-align: left;”> <img src=“https://github.com/SkyworkAI/Mureka-mcp/blob/master/assets/demo1.jpeg?raw=true” width=“400”> </div>
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 <div class=“title-block” style=“text-align: left;”> <img src=“https://raw.githubusercontent.com/SkyworkAI/Mureka-mcp/refs/heads/master/assets/openai_1.jpeg” width=“400”> </div> <div class=“title-block” style=“text-align: left;”> <img src=“https://raw.githubusercontent.com/SkyworkAI/Mureka-mcp/refs/heads/master/assets/openai_2.jpeg” width=“400”> </div>