Quickstart with Claude Desktop

基本能力

产品定位

Mureka-mcp 是一个专注于音乐内容生成的 MCP 服务器，通过与 Mureka 的 API 交互，为用户提供歌词、歌曲和背景音乐的生成能力。

核心功能

1. 歌词生成：根据用户需求生成定制化的歌词。
2. 歌曲生成：基于生成的歌词或用户提供的歌词创作完整的歌曲。
3. 背景音乐生成：生成适合特定场景（如咖啡厅）的背景音乐。
4. API 集成：支持与 Mureka 的 API 无缝集成，提供高效的生成服务。

适用场景

1. 个人创作：为个人或家庭活动（如生日）创作定制歌曲。
2. 商业用途：为商业场景（如咖啡厅、广告）生成背景音乐。
3. 节日庆祝：为节日（如圣诞节）生成相关主题的歌词和音乐。

工具列表

1. 歌词生成工具：根据用户输入生成歌词。
2. 歌曲生成工具：基于歌词生成完整的歌曲。
3. 背景音乐生成工具：生成适合特定场景的背景音乐。
4. API 配置工具：支持通过环境变量配置 API 密钥和超时设置。

常见问题解答

1. 日志查看：
2. Windows：%APPDATA%\Claude\logs\mcp-server-Mureka.log
3. macOS：~/Library/Logs/Claude/mcp-server-Mureka.log
4. 超时设置：可通过 TIME_OUT_SECONDS 环境变量设置生成超时时间（默认 60 秒）。

使用教程

使用依赖

1. 获取 Mureka API 密钥：Mureka API Keys。
2. 安装 uv（Python 包管理器）： bash curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

1. 在 Claude Desktop 的配置文件中添加以下内容（claude_desktop_config.json）： 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" } } } }
2. 重启 Claude 应用，确认窗口中显示 4 个 MCP 工具，表示加载成功。

调试方式

1. 查看日志文件以排查问题：
2. Windows：%APPDATA%\Claude\logs\mcp-server-Mureka.log
3. macOS：~/Library/Logs/Claude/mcp-server-Mureka.log
4. 使用示例命令测试功能：
5. "Please create a song for my daughter Jessica to wish her a happy birthday and play it"
6. "Please generate lyrics about Christmas"
7. "Please generate a song based on the lyrics just now"
8. "Please generate background music suitable for playing in the coffee shop"

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。