STARWARCLOUD STARWAR.AI
返回市场
MCP-极小值音乐服务器

MCP-极小值音乐服务器

作者：falahgs5 星标更新：2025-04-17
安装使用来源：spider==github.com

项目介绍

MCP MiniMax 音乐服务器

版本 许可证

这是一个使用MiniMax音乐API进行AI驱动音频生成的Model Context Protocol (MCP)服务器实现。由Falah.G.Salieh开发。

📋 目录

🎯 概述

此MCP服务器允许AI代理通过Model Context Protocol使用MiniMax音乐API生成音乐和音频内容。它提供了与Claude Desktop等MCP主机的无缝集成，使AI代理能够根据文本提示创建音乐和音频。

✨ 特性

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

🔧 先决条件

  • Node.js (v16或更高版本)
  • TypeScript (v5.3.3或更高版本)
  • Claude Desktop (最新版本)
  • 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 Desktop配置

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

    • Windows: %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密钥前添加"Bear "前缀
    • 在Windows路径中使用双反斜杠

API密钥设置

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

  1. 环境变量（推荐）

    • 如上所示在Claude Desktop配置中设置
    • 使用"Bear "前缀（包括空格）
    • 示例："AIML_API_KEY": "Bearer 3d90d64a000c4e6eb02df7e52d2166d2"

  2. 直接配置

    • 在生成请求中直接传递API密钥
    • 不太安全，但适用于测试

🚀 使用

基本用法

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

  • prompt（必需）：用于音频生成的文本提示
  • model（可选）：设置为"minimax-music"
  • reference_audio_url（可选）：参考音频的URL
  • generation_id（可选）：用于状态检查的先前生成ID

示例命令

  1. 开始新的生成：

    使用提示“创作一首带有轻柔原声吉他和柔和人声的浪漫情歌”生成音频

  2. 检查生成状态：

    使用生成ID“abc1123”和提示“检查状态”生成音频

响应格式

{
  "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音乐模型，其特点如下：

  • 专门用于音乐生成
  • 需要参考音频以匹配风格
  • 支持使用##分隔符生成歌词
  • 生成高质量的音乐输出

生成过程

  1. 步骤1：提交生成

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

  2. 步骤2：检查状态

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

🔍 故障排除

常见问题

  1. 身份验证错误（401）

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

  2. 路径问题

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

  3. 生成错误

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

调试步骤

  1. 重新构建服务器：

    npm run build

  2. 重启Claude Desktop

  3. 检查服务器日志中的错误

🤝 贡献

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

📄 许可证

MIT许可证 - 查看LICENSE文件获取详情

👤 作者

Falah.G.Salieh

  • 地址：巴格达，伊拉克
  • 角色：开发者及AI集成专家
  • 年份：2025

🌟 支持

需要帮助？这里是如何获得支持的方法：

  1. 查看故障排除部分
  2. 在仓库中打开一个issue
  3. 直接联系作者

该项目是Model Context Protocol生态系统的一部分，实现了AI代理与外部服务之间的无缝集成。