mcpField
M
Mureka Mcp

Mureka Mcp

本地服务
github.com/SkyworkAI媒体与设计12376 周前更新

关于 Mureka Mcp

Mureka MCP 服务是 Mureka 官方提供的 MCP 服务,用于调用其歌词、歌曲与背景音乐(纯音乐)生成 API。适合希望在 Claude Desktop 等 MCP 客户端中直接生成音乐内容的用户。

主要功能

  1. 01生成歌词
  2. 02生成歌曲
  3. 03生成背景音乐(纯音乐)
  4. 04可通过环境变量设置生成等待超时

适用场景

  1. 01根据主题生成一首生日祝福歌曲
  2. 02为咖啡店等场景生成背景音乐
  3. 03先生成歌词,再基于歌词生成歌曲

MCP 相关

该项目是 MCP 服务,向 Claude Desktop、OpenAI Agents 等 MCP 客户端提供歌词、歌曲和背景音乐生成的工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"Mureka": {
"command": "uvx",
"args": [
"mureka-mcp"
],
"env": {
"MUREKA_API_KEY": "<MUREKA_API_KEY>",
"MUREKA_API_URL": "<MUREKA_API_URL>",
"TIME_OUT_SECONDS": "<TIME_OUT_SECONDS>"
}
}
}
}
启动命令uvx mureka-mcp
需要配置的环境变量
MUREKA_API_KEY密钥
MUREKA_API_URL
TIME_OUT_SECONDS

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypimureka-mcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

导出

Discord 社区 Twitter PyPI

Mureka 官方 Model Context Protocol(MCP)服务,可与强大的歌词、歌曲和背景音乐生成 API 交互。此服务可让 Claude Desktop、OpenAI Agents 等 MCP 客户端生成歌词、歌曲和背景音乐(纯音乐)。

使用 Claude Desktop 快速入门

  1. 从 Mureka 获取 API 密钥。
  2. 安装 uv(Python 包管理器),可使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安装,或参阅 uv 代码库了解其他安装方法。
  3. 前往 Claude > Settings > Developer > Edit Config > claude_desktop_config.json,并添加以下内容:
{
    "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"
            }
        }
    }
}

然后重启 Claude 应用。在窗口中看到 4 个可用的 MCP 工具,即表示加载成功。

README 配图

可选功能

你可以在 claude_desktop_config.json 中添加 TIME_OUT_SECONDS 环境变量,以设置等待歌曲或背景音乐生成的超时时间(默认 60s)。

使用示例

⚠️ 警告:使用这些工具需要 Mureka 点数。 尝试向 Claude 提出以下请求:

  • “请为我的女儿 Jessica 创作一首生日快乐歌曲并播放”
README 配图
  • “请创作一段关于圣诞节的歌词”
  • “请根据刚才的歌词创作一首歌曲”
  • “请创作适合在咖啡店播放的背景音乐”
README 配图

背景音乐 1 下载

背景音乐 2 下载

故障排除

使用 Claude Desktop 运行时,日志位于:

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

使用 OpenAI Agents SDK 快速入门

安装 Agents SDK

pip install openai-agents

运行示例:openapi_agents_example/main.py

需要填写密钥:

MUREKA_API_KEY = "<insert-your-api-key-here>"

运行后,你可以在控制台中查看作曲过程。

README 配图
README 配图

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。