
MCP MiniMax Music Server

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
(可选):参考音频的 URLgeneration_id
(可选):用于状态检查的先前生成的 ID
常见问题解答
- 认证错误 (401)
- 检查 API 密钥格式(应以 "Bearer " 开头)
- 验证 API 密钥的有效性
- 确保
claude_desktop_config.json
中的配置正确 - 路径问题
- 使用正确的路径格式(Windows 使用双反斜杠)
- 验证构建目录是否存在
- 生成错误
- 检查提示格式(歌词应包裹在 ##...## 中)
- 确保参考音频 URL 可访问
- 验证提示长度和内容
使用教程
使用依赖
- Node.js(v16 或更高版本)
- TypeScript(v5.3.3 或更高版本)
- Claude Desktop(最新版本)
- AIML API 密钥
- Windows/Linux/macOS 操作系统
安装教程
- 克隆仓库:
bash git clone https://github.com/yourusername/mcp-minimax-music-server.git cd mcp-minimax-music-server
- 安装依赖:
bash npm install
- 构建服务器:
bash npm run build
调试方式
- 重新构建服务器:
bash npm run build
- 重启 Claude Desktop
- 检查服务器日志中的错误