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 信用。