Ai Music Mcp

Name: Ai Music Mcp
Author: amCharlie

本地服务

github.com/amCharlie媒体与设计350 周前更新

代码仓库

关于 Ai Music Mcp

Ai Music Mcp 是连接 MusicMCP.AI 音乐生成平台的 MCP 服务，适用于通过自然语言创作歌曲的 MCP 客户端。支持灵感和自定义模式，并自动轮询生成状态。

主要功能

01按文本描述生成歌曲
02支持灵感与自定义生成模式
03生成纯音乐或带人声歌曲
04返回歌曲下载链接
05查询 API 密钥额度与服务状态

适用场景

01根据主题描述生成歌曲
02按指定标题、歌词和风格创作
03生成纯音乐曲目
04检查账户额度或 API 健康状态

MCP 相关

该 MCP 服务向 MCP 客户端提供歌曲生成、额度查询和 API 健康检查工具，并自动轮询异步生成任务直至完成。

#ai-music #music #suno

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "aimusic-mcp-tool": {
      "command": "uvx",
      "args": [
        "aimusic-mcp"
      ],
      "env": {
        "MUSICMCP_API_KEY": "<MUSICMCP_API_KEY>",
        "MUSICMCP_API_URL": "<MUSICMCP_API_URL>",
        "TIME_OUT_SECONDS": "<TIME_OUT_SECONDS>"
      }
    }
  }
}

启动命令uvx aimusic-mcp

需要配置的环境变量

MUSICMCP_API_KEY密钥

MUSICMCP_API_URL

TIME_OUT_SECONDS

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiaimusic-mcpstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

🎵 MusicMCP.AI MCP 服务

借助 Model Context Protocol 实现 AI 音乐生成

MusicMCP.AI 官方 Model Context Protocol（MCP）服务，可与我们的先进 AI 音乐生成平台无缝交互。此服务支持 Claude Desktop、OpenAI Agents 等 MCP 客户端通过自然语言命令生成 AI 音乐。

✨ 功能

🎼 AI 音乐生成：使用 MusicMCP.AI 最先进的 AI 模型，根据文本提示词生成歌曲
🎵 双重生成模式：支持灵感模式和自定义模式
🔗 直接下载链接：获取生成音乐的直接下载 URL
🎹 纯器乐选项：生成纯器乐音乐，或带人声的完整歌曲
✅ 积分余额查询：检查 API 密钥是否有效以及剩余积分
🏥 健康监控：检查 API 服务的健康状态

🚀 Claude Desktop 快速入门

获取 API 密钥：从 MusicMCP.AI Platform 获取 API 密钥
安装 uv：使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安装 Python 包管理器
配置 Claude：前往 Claude > Settings > Developer > Edit Config > claude_desktop_config.json 并添加：

{
    "mcpServers": {
        "MusicMCP.AI": {
            "command": "uvx",
            "args": [
                "aimusic-mcp"
            ],
            "env": {
                "MUSICMCP_API_KEY": "<insert-your-api-key-here>",
                "MUSICMCP_API_URL": "https://www.musicmcp.ai/api",
                "TIME_OUT_SECONDS": "600"
            }
        }
    }
}

重启 Claude：重启 Claude 应用，你将看到 4 个 MCP 工具 可用，这表示加载成功

⚙️ 环境变量

变量	描述	默认值	必需
`MUSICMCP_API_KEY`	你的 MusicMCP.AI API 密钥	-	✅ 是
`MUSICMCP_API_URL`	MusicMCP.AI API 基础 URL	`https://www.musicmcp.ai/api`	❌ 否
`TIME_OUT_SECONDS`	音乐生成超时时间（秒）	`600`（10 分钟）	❌ 否

🛠️ 可用工具

1. 🎼 生成提示词歌曲（灵感模式）

根据简单的文本描述生成 AI 音乐。AI 会自动创作标题、歌词和风格。

费用：每次生成消耗 5 积分（生成 2 首歌曲）

参数：

prompt（str）：对音乐主题的简单描述（1-1200 个字符）
instrumental（bool）：是否仅生成器乐
style（str，可选）：音乐风格（例如，“ambient”“pop”“rock”）

提示词示例：

"Help me generate a song about a peaceful morning"
"Want a song that expresses longing"
"Create music about friendship"

输出示例：

✅ Song 1 generated successfully!

📌 Title: Peaceful Morning
🆔 ID: c7630638-b8ba-4984-876b-6dd7e6eeb796
🔗 Download URL: https://cdn.musicmcp.ai/songs/abc123.mp3
🖼️  Cover Image: https://cdn.musicmcp.ai/images/abc123.jpg
⏱️  Duration: 180s
🎵 Style Tags: ambient, meditation, peaceful
🎹 Instrumental: No
📅 Created: 2025-01-15T10:30:45.123Z
📝 Lyrics:
[Verse]
Gentle sunlight fills the room
Morning dew and sweet perfume
Birds are singing their refrain
Another peaceful day again

You can download or play the audio from the URL above.

✅ Song 2 generated successfully!

📌 Title: Morning Peace
🆔 ID: d8741749-c9cb-5095-987c-7ee8f7ffb907
🔗 Download URL: https://cdn.musicmcp.ai/songs/def456.mp3
🖼️  Cover Image: https://cdn.musicmcp.ai/images/def456.jpg
⏱️  Duration: 213s
🎵 Style Tags: ambient, meditation, peaceful
🎹 Instrumental: No
📅 Created: 2025-01-15T10:30:45.126Z
📝 Lyrics:
[Verse]
Calm and quiet, soft and still
Peaceful thoughts upon the hill
Nature's beauty all around
Gentle whispers, soothing sound

You can download or play the audio from the URL above.

2. 🎵 生成自定义歌曲（自定义模式）

使用你提供的指定歌词、标题和风格参数生成 AI 音乐。

费用：每次生成消耗 5 积分（生成 2 首歌曲）

参数：

title（str）：歌曲标题（必填）
instrumental（bool）：是否仅生成器乐（必填）
lyric（str，可选）：完整歌词内容（当 instrumental 为 true 时无需提供）
tags（str，可选）：音乐风格标签（例如，'pop'、'rock'、'folk'）

用法示例：

Please help me generate a song:
Title: Summer Dreams
Lyrics: [complete lyrics content]
Style: folk

Or for instrumental:
Title: Summer Breeze
Instrumental: yes
Style: ambient

输出示例：

✅ Custom song 'Summer Dreams' (version 1) generated successfully!

📌 Title: Summer Dreams
🆔 ID: d1ed75a7-3e0b-42c6-b2be-7631204074fe
🔗 Download URL: https://cdn.musicmcp.ai/songs/xyz789.mp3
🖼️ Cover Image: https://cdn.musicmcp.ai/images/xyz789.jpg
⏱️ Duration: 195s
🎵 Style Tags: folk, acoustic, summer
🎹 Instrumental: No
📅 Created: 2025-01-15T11:45:30.456Z
📝 Lyrics:
[Verse]
Walking through the summer fields
Golden wheat and nature's yields
Sunshine dancing on my face
Summer's warm and sweet embrace

You can download or play the audio from the URL above.

✅ Custom song 'Summer Dreams' (version 2) generated successfully!

📌 Title: Summer Dreams
🆔 ID: e2fe86b8-4f1c-53d7-c3cf-8742305185gf
🔗 Download URL: https://cdn.musicmcp.ai/songs/uvw012.mp3
🖼️ Cover Image: https://cdn.musicmcp.ai/images/uvw012.jpg
⏱️ Duration: 203s
🎵 Style Tags: folk, acoustic, summer
🎹 Instrumental: No
📅 Created: 2025-01-15T11:45:30.459Z
📝 Lyrics:
[Verse]
Walking through the summer fields
Golden wheat and nature's yields
Sunshine dancing on my face
Summer's warm and sweet embrace

You can download or play the audio from the URL above.

3. ✅ 查询积分余额

检查 API 密钥是否有效，并查看剩余积分。

费用：免费

用法示例：

"Check my credit balance"
"How many credits do I have left?"

4. 🏥 检查 API 健康状态

监控 MusicMCP.AI API 服务的健康状态。

费用：免费

用法示例：

"Check API service status"

💰 积分与定价

操作	积分费用	输出
生成灵感音乐	5 积分	2 首歌曲
生成自定义音乐	5 积分	2 首歌曲
查询音乐状态	0 积分（免费）	-
查询积分余额	0 积分（免费）	-
检查 API 健康状态	0 积分（免费）	-

💡 用法示例

⚠️ 注意：使用音乐生成工具需要 MusicMCP.AI 积分。

尝试向 Claude 提问：

灵感模式：

“请帮我创作一首关于宁静早晨的歌曲”
“想要一首表达思念的歌曲”
“创作一首关于友谊的音乐”
“生成一首氛围音乐曲目”

自定义模式：

“请帮我创作一首歌，标题：Summer Dreams，歌词：[完整歌词]，风格：民谣”
“创作一首歌，标题：Spring Promise，歌词：[完整歌词]，流行风格”
“生成一首纯音乐，标题：Ocean Breeze，风格：氛围音乐”

管理功能：

“查看我的积分余额”
“我还剩多少积分？”
“查看 API 服务状态”

📦 安装

使用 uv（推荐）

uvx aimusic-mcp

使用 pip

pip install aimusic-mcp

🔌 API 集成

此 MCP 服务集成了 MusicMCP.AI 的 RESTful API：

POST /music/generate/inspiration：创建音乐生成任务（灵感模式）
POST /music/generate/custom：创建自定义音乐生成任务
POST /music/generate/query：查询音乐状态（支持批量查询）
GET /credit：查看积分余额
GET /health：检查 API 服务运行状况

🔄 异步 API 工作流

音乐生成是异步的。MCP 服务会自动处理：

步骤 1：提交生成请求

POST /music/generate/inspiration or /music/generate/custom
→ Returns: {"code": 200, "data": {"ids": ["id1", "id2"]}}

步骤 2：自动轮询（由 MCP 内部处理）

POST /music/generate/query with {"ids": ["id1", "id2"]}
→ Polls every 2 seconds until status = 1 (completed)
→ Song status: 0 = Failed, 1 = Completed, 2 = In Progress

步骤 3：返回完整歌曲信息

Once all songs are completed, returns full details:
- songName, songUrl, imgUrl, duration, tags, etc.

幕后流程：

用户调用 generate_prompt_song() 或 generate_custom_song()
MCP 发送生成请求 → 接收 2 个歌曲 ID
MCP 每隔 2 秒自动轮询 /music/generate/query
所有歌曲生成完成后（status=1），返回下载 URL
默认超时时间：10 分钟（可通过 TIME_OUT_SECONDS 配置）

重要说明：

⏱️ 每首歌通常需要 2-5 分钟生成
🔁 MCP 服务会自动处理所有轮询
🎵 每次生成都会生成 2 个歌曲版本
💰 生成请求成功后会扣除积分（5）
⚠️ 如果生成失败，不会扣除积分

🐛 故障排除

常见问题

API Key 错误：请确保正确设置了 MUSICMCP_API_KEY
- 使用 check_credit_balance 工具检查密钥
积分不足（402 错误）：您的积分不足
- 在 https://www.musicmcp.ai 查看余额
- 为账户充值
超时错误：如果音乐生成耗时较长，请增大 TIME_OUT_SECONDS

日志

使用 Claude Desktop 运行时，可在以下位置找到日志：

Windows：%APPDATA%\Claude\logs\mcp-server-MusicMCP.AI.log
macOS：~/Library/Logs/Claude/mcp-server-MusicMCP.AI.log

🧪 开发

运行测试

pytest tests/

本地开发

python -m musicmcp_ai_mcp.api

代码结构

musicmcp_ai_mcp/
├── __init__.py          # Package initialization
├── __main__.py          # CLI entry point
└── api.py               # Core MCP server implementation (430 lines)

🔗 链接

📄 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

由 MusicMCP.AI 团队用 ❤️ 打造

借助 AI 将您的创意变成音乐

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Ai Music Mcp

关于 Ai Music Mcp

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

🎵 MusicMCP.AI MCP 服务

✨ 功能

🚀 Claude Desktop 快速入门

⚙️ 环境变量

🛠️ 可用工具

1. 🎼 生成提示词歌曲（灵感模式）

2. 🎵 生成自定义歌曲（自定义模式）

3. ✅ 查询积分余额

4. 🏥 检查 API 健康状态

💰 积分与定价

💡 用法示例

尝试向 Claude 提问：

灵感模式：

自定义模式：

管理功能：

📦 安装

使用 uv（推荐）

使用 pip

🔌 API 集成

🔄 异步 API 工作流

🐛 故障排除

常见问题

日志

🧪 开发

运行测试

本地开发

代码结构

🔗 链接

📄 许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？