AI导哈

AI音乐生成服务器

基于MiniMax Music API的AI音乐生成服务器，通过Model Context Protocol实现与Claude Desktop等MCP主机的无缝集成，支持根据文本提示生成音乐和音频内容。

  • by falahgs
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 falahgs/mcp-minimax-music-server

使用说明

MCP MiniMax音乐服务器

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

📋 目录

🎯 概述

该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

  2. 安装依赖项：

    npm install

  3. 构建服务器：

    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

  2. 添加以下配置：

    {
  "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"

  2. 直接配置

    • 在生成请求中直接传递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"

  2. 检查生成状态：

    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

  2. 步骤2：检查状态

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

🔍 故障排除

常见问题

  1. 身份验证错误（401）

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

  2. 路径问题

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

  3. 生成错误

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

调试步骤

  1. 重建服务器：

    npm run build

  2. 重新启动克劳德桌面

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

🤝 贡献

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

📄 许可证

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

👤 作者

法拉。G.萨利耶

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

🌟 支持

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

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

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

相关 MCP