Mureka.ai Music Generation

🚀 Mureka 模型上下文协议（MCP）服务器官方文档

Mureka 模型上下文协议（MCP）服务器是一个可与强大的歌词、歌曲和背景音乐生成 API 进行交互的工具。此服务器允许 MCP 客户端，如 Claude Desktop 和 OpenAI Agents 等，生成歌词、歌曲和背景音乐（乐器演奏）。

🚀 快速开始

使用 Claude Desktop 快速入门

1. 从 Mureka 获取您的 API 密钥。
2. 安装 uv（Python 包管理器），使用 curl -LsSf https://astral.sh/uv/install.sh | sh 或访问 uv 仓库 了解其他安装方法。
3. 打开 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，添加以下内容：

{
    "mcpServers": {
        "Mureka": {
            "command": "uvx",
            "args": [
                "mureka-mcp"
            ],
            "env": {
                "MUREKA_API_KEY": "<此处插入您的API密钥>",
                "MUREKA_API_URL": "https://api.mureka.ai",
                "TIME_OUT_SECONDS":"300"
            }
        }
    }
}

然后重启 Claude 应用，窗口中将显示 4 个 MCP 工具，表示加载成功。

使用 Openai agents sdk 快速入门

安装 Agents SDK

pip install openai-agents

运行示例：openapi_agents_example/main.py

需要填写的密钥：

MUREKA_API_KEY = "<此处插入您的API密钥>"

运行后，您可以在控制台中看到作曲过程。

✨ 主要特性

此服务器允许 MCP 客户端如 Claude Desktop 和 OpenAI Agents 等生成歌词、歌曲和背景音乐（乐器演奏）。

📦 安装指南

安装 uv

使用 curl -LsSf https://astral.sh/uv/install.sh | sh 或访问 uv 仓库 了解其他安装方法。

安装 Agents SDK

pip install openai-agents

💻 使用示例

基础用法

⚠️ 注意：使用这些工具需要 Mureka 信用。 尝试让 Claude 做以下事情：

• "请为我的女儿杰西卡创作一首生日快乐歌并播放它"
• "请根据刚刚生成的歌词生成一首歌曲"
• "请生成适合在咖啡店播放的背景音乐"

可选功能

您可以在 claude_desktop_config.json 中添加 TIME_OUT_SECONDS 环境变量，以设置歌曲或背景音乐生成等待的超时时间（默认 60 秒）。

🔧 故障排除

运行时日志（与 Claude Desktop 一起使用）可以在以下位置找到：

• Windows：%APPDATA%\Claude\logs\mcp-server-Mureka.log
• macOS：~/Library/Logs/Claude/mcp-server-Mureka.log

⚠️ 重要提示

使用这些工具需要 Mureka 信用。