项目简介

Mureka内容生成MCP服务器是官方实现的基于 Model Context Protocol (MCP) 的后端服务，用于将 Mureka AI 的音乐内容生成（包括歌词、歌曲、背景音乐）及音频播放能力暴露给支持 MCP 协议的 LLM 客户端（如 Claude Desktop）。

主要功能点

歌词生成: 根据用户提供的文本提示，调用 Mureka AI 生成高质量的歌词。
歌曲生成: 基于用户提供的歌词和可选的风格描述，调用 Mureka AI 生成包含人声的歌曲音频文件，并将文件保存到本地指定目录。
背景音乐生成: 根据用户提供的风格描述，调用 Mureka AI 生成纯器乐的背景音乐音频文件，并将文件保存到本地指定目录。
音频播放: 提供一个工具，允许 LLM 客户端请求播放本地的音频文件（支持 WAV 和 MP3 格式）。

安装步骤

确保你已安装 Python 3.10 或更高版本。
安装 'uv' (一个快速的 Python 包管理器)，如果尚未安装，可以通过以下命令之一安装（更多方法请参考 'uv' 官方仓库）：
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```

使用 'uv' 安装 Mureka MCP 服务器软件包：

uv pip install mureka-mcp

服务器配置（客户端侧）

MCP 服务器需要由支持 MCP 协议的 LLM 客户端启动和管理。客户端通常通过一个配置文件来指定要启动的 MCP 服务器及其参数。以下是配置 Mureka MCP 服务器所需的关键信息，你需要将这些信息添加到你的 MCP 客户端的配置文件中（例如 Claude Desktop 的 'claude_desktop_config.json' 文件）：

服务器名称: 你可以为服务器指定一个名称，例如 "Mureka"。
启动命令 (command): 启动 MCP 服务器的可执行命令。对于此项目，命令是 'uvx'。
命令参数 (args): 传递给启动命令的参数。对于此项目，参数是 '["mureka-mcp"]'。
环境变量 (env): MCP 服务器运行时需要的环境变量。
- 'MUREKA_API_KEY': 必填。你的 Mureka API 密钥，用于调用 Mureka AI 的服务。请从 Mureka 平台获取你的 API 密钥。
- 'MUREKA_API_URL': 可选。Mureka API 的基础 URL，默认为 'https://api.mureka.ai'。
- 'TIME_OUT_SECONDS': 可选。设置歌曲或背景音乐生成的等待超时时间（秒），默认为 60 秒。

例如，在 Claude Desktop 中，你需要在 'claude_desktop_config.json' 的 'mcpServers' 部分添加类似以下结构的配置（请勿直接复制，理解结构并根据你的客户端格式填写）：

{
  "mcpServers": {
    "你的服务器名称": { // 例如 "Mureka"
      "command": "uvx",
      "args": [
        "mureka-mcp"
      ],
      "env": {
        "MUREKA_API_KEY": "<在此处插入你的Mureka API密钥>",
        "MUREKA_API_URL": "https://api.mureka.ai",
        "TIME_OUT_SECONDS": "300"
      }
    }
  }
}

配置完成后，重启你的 MCP 客户端。客户端应该能检测到并加载该 MCP 服务器提供的工具。

基本使用方法

在配置好 Mureka MCP 服务器并重启客户端后，你可以通过与 LLM 客户端对话来使用 Mureka 的音乐生成工具。LLM 会根据你的指令，判断是否需要调用 MCP 服务器上的工具来完成任务。

尝试向 LLM 客户端发出以下类型的指令：

“请为我女儿 Jessica 写一首生日歌的歌词。” (会调用生成歌词工具)
“请根据刚才的歌词生成一首歌曲并播放。” (会先调用生成歌曲工具，成功后再调用播放音频工具)
“请生成一首适合在咖啡馆播放的背景音乐。” (会调用生成背景音乐工具)
“请播放文件 '/path/to/your/audio.mp3'。” (会调用播放音频工具，请替换为实际文件路径)

注意: 调用 Mureka AI API 可能会产生费用，请确保你了解相关的计费规则。

关键词

项目简介

主要功能点

安装步骤

服务器配置（客户端侧）

基本使用方法

信息