MCP MiniMax Music Server

MCP MiniMax Music Server

site icon
2025.04.17 0
TypeScript音乐生成AI 音频生成内容生成
MCP MiniMax Music Server 是一个基于 Model Context Protocol (MCP) 的服务,用于通过 MiniMax Music API 进行 AI 驱动的音频生成。它提供了与 MCP 主机(如 Claude Desktop)的无缝集成,使 AI 代理能够根据文本提示创建音乐和音频内容。
View on GitHub

Overview

基本能力

产品定位

MCP MiniMax Music Server 是一个 AI 驱动的音乐生成服务,旨在通过文本提示生成高质量的音乐和音频内容。

核心功能

  • AI 驱动的音乐生成
  • 支持 MiniMax Music 模型
  • 两步生成过程(提交生成和状态检查)
  • 与 Claude Desktop 无缝集成
  • 支持环境变量配置 API 密钥
  • 详细的错误处理和报告

适用场景

  • AI 代理生成音乐和音频内容
  • 需要根据文本提示生成音乐的应用
  • 与 Claude Desktop 集成的音乐生成服务

工具列表

  • generate_audio:用于生成音频的工具,支持以下参数:
  • prompt(必需):音频生成的文本提示
  • model(可选):设置为 "minimax-music"
  • reference_audio_url(可选):参考音频的 URL
  • generation_id(可选):用于状态检查的先前生成的 ID

常见问题解答

  1. 认证错误 (401)
  2. 检查 API 密钥格式(应以 "Bearer " 开头)
  3. 验证 API 密钥的有效性
  4. 确保 claude_desktop_config.json 中的配置正确
  5. 路径问题
  6. 使用正确的路径格式(Windows 使用双反斜杠)
  7. 验证构建目录是否存在
  8. 生成错误
  9. 检查提示格式(歌词应包裹在 ##...## 中)
  10. 确保参考音频 URL 可访问
  11. 验证提示长度和内容

使用教程

使用依赖

  • Node.js(v16 或更高版本)
  • TypeScript(v5.3.3 或更高版本)
  • Claude Desktop(最新版本)
  • AIML API 密钥
  • Windows/Linux/macOS 操作系统

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/mcp-minimax-music-server.git cd mcp-minimax-music-server
  2. 安装依赖: bash npm install
  3. 构建服务器: bash npm run build

调试方式

  1. 重新构建服务器: bash npm run build
  2. 重启 Claude Desktop
  3. 检查服务器日志中的错误

许可证

该项目遵循 MIT 开源许可条款。