MCP MiniMax Music Server

MCP MiniMax音乐服务器

一种使用MiniMax Music API生成AI供电音频的模型上下文协议（MCP）服务器实现。由Falah开发。G.萨利耶。

📋 目录

• 概述
• 特性
• 先决条件
• 安装
• 配置
• 用法
• api参考
• 故障排除
• 贡献
• 许可证
• 作者

🎯 概述

该MCP服务器使AI代理能够通过模型上下文协议使用MiniMax music API生成音乐和音频内容。它与Claude Desktop等MCP主机无缝集成，允许AI代理根据文本提示创建音乐和音频。

✨ 特性

• AI驱动的音乐生成
• 支持MiniMax音乐模式
• 带有状态检查的两步生成过程
• 与Claude Desktop无缝集成
• 对API密钥的环境变量支持
• 详细的错误处理和报告

🔧 先决条件

• Node.js（v16或更高版本）
• TypeScript（v5.3.3或更高版本）
• 克劳德桌面（最新版本）
• AIML API密钥
• Windows/Linux/macOS操作系统

📦 安装

1. 克隆存储库：

   git clone https://github.com/yourusername/mcp-minimax-music-server.git
   cd mcp-minimax-music-server

1. 安装依赖项：

   npm install

1. 构建服务器：

   npm run build

⚙️ 配置

Claude桌面配置

1. 找到您的Claude Desktop配置文件：

- 窗户： %APPDATA%\Claude\claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json - macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

1. 添加以下配置：

   {
     "mcpServers": {
       "minimax-music-server": {
         "command": "node",
         "args": [
           "G:\\mcp-minimax-music-server\\build\\index.js"
         ],
         "env": {
           "AIML_API_KEY": "Bearer your-aiml-api-key-here"
         }
       }
     }
   }

> ⚠️ 重要: > > - 将路径替换为实际的服务器路径 > - 在API密钥中添加“Bearer”前缀 > - 在Windows路径中使用双反斜杠

API密钥设置

您的AIML API密钥可以通过两种方式进行配置：

1. 环境变量（推荐）

- 在Claude Desktop配置中设置，如上所示 - 前缀为“Bearer”（包括空格） - 例子： "AIML_API_KEY": "Bearer 3d90d64a000c4e6eb02df7e52d2166d2"

1. 直接配置

- 在生成请求中直接传递API密钥 - 安全性较低，但可用于测试

🚀 用法

基本用法

服务器提供了一个名为 generate_audio 具有以下参数：

• prompt （必填）：用于音频生成的文本提示
• model （可选）：设置为“最小最大音乐”
• reference_audio_url （可选）：参考音频的URL
• generation_id （可选）：用于状态检查的上一代ID

示例命令

1. 启动新一代：

   Generate audio with prompt "Create a romantic love song with gentle acoustic guitar and soft vocals"

1. 检查生成状态：

   Generate audio with generation_id "abc123" and prompt "Check status"

响应格式

{
  "toolResult": {
    "status": "completed",
    "id": "generation-id",
    "audio_file": {
      "url": "https://cdn.example.com/audio.mp3",
      "content_type": "audio/mpeg",
      "file_name": "output.mp3",
      "file_size": 1024000
    }
  }
}

📚 api参考

MiniMax音乐模型

服务器使用MiniMax Music模型，该模型：

• 擅长音乐创作
• 需要参考音频进行风格匹配
• 支持使用##分隔符生成歌词
• 生成高质量的音乐输出

生成过程

1. 步骤1：提交生成

- 发送提示和参数 - 接收生成ID

1. 步骤2：检查状态

- 使用生成ID轮询状态 - 完成后下载音频

🔍 故障排除

常见问题

1. 身份验证错误（401）

- 验证API密钥格式（应以“Bearer”开头） - 检查API密钥的有效性 - 确保中的配置正确 claude_desktop_config.json

1. 路径问题

- 为您的操作系统使用正确的路径格式 - Windows：使用双反斜杠 - 验证生成目录是否存在

1. 生成错误

- 检查提示格式（歌词应包裹在##…##中） - 确保参考音频URL可访问 - 验证提示长度和内容

调试步骤

1. 重建服务器：

   npm run build

1. 重新启动克劳德桌面

1. 检查服务器日志是否有错误

🤝 贡献

1. 分叉存储库
2. 创建功能分支
3. 提交您的更改
4. 推到分支
5. 创建拉取请求

📄 许可证

MIT许可证-请参阅 许可证 详细信息文件

👤 作者

法拉。G.萨利耶

• 地点：伊拉克巴格达
• 职位：开发人员和人工智能集成专家
• 年份：2025

🌟 支持

需要帮助？以下是如何获得支持：

1. 检查故障排除部分
2. 在存储库中打开问题
3. 直接联系作者

______________________________________________________________________

*该项目是模型上下文协议生态系统的一部分，实现了人工智能代理和外部服务之间的无缝集成。*