Music MCP AI

🎵 音乐MCP。AI MCP服务器

基于模型上下文协议的人工智能音乐生成

✨ 特性

• 🎼 AI音乐生成：使用MusicMCP根据文本提示生成歌曲。AI最先进的AI模型
• 🎵 双代模式：支持灵感模式和自定义模式
• 🔗 直接下载链接：获取生成音乐的直接下载URL
• 🎹 工具选项：生成纯器乐音乐或带人声的完整歌曲
• ✅ 信用余额检查：检查您的API密钥有效性和剩余信用
• 🏥 健康监测：检查API服务运行状况

🚀 Claude Desktop快速入门

1. 获取API密钥：从获取API密钥 音乐MCP。AI平台
2. 安装uv：安装Python包管理器 curl -LsSf https://astral.sh/uv/install.sh | sh
3. 配置Claude：转到Claude>设置>开发人员>编辑配置>Claude_desktop_Config.json并添加：

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

1. 重新启动克劳德：重新启动Claude应用程序，您将看到 4个MCP工具 可用，表示加载成功

⚙️ 环境变量

🛠️ 可用工具

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

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

成本：每代5个学分（创作2首歌曲）

参数：

• prompt （str）：音乐主题的简单描述（1-1200个字符）
• instrumental （bool）：是否只生成器乐
• style （str，可选）：音乐风格（例如，“氛围”、“流行”、“摇滚”）

示例提示：

"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，可选）：完整的歌词内容（当器乐为真时不需要）
• tags （str，可选）：音乐风格标签（例如，“流行”、“摇滚”、“民谣”）

示例用法：

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"

💰 积分和定价

💡 示例用法

⚠️ 备注：音乐MCP。使用音乐生成工具需要AI学分。

试着问克劳德：

灵感模式：

• “请帮我创作一首关于宁静早晨的歌曲”
• “想要一首表达渴望的歌”
• “创作关于友谊的音乐”
• “生成环境音乐曲目”

自定义模式：

• “请帮我创作一首歌，标题：夏日之梦，歌词：\[完整歌词\]，风格：民谣”
• “创作一首歌，标题：春天的承诺，歌词：\[完整歌词\]，流行风格”
• 创作一首器乐歌曲，标题：《海风》，风格：氛围

管理职能：

• “检查我的信用余额”
• “我还剩多少学分？”
• “检查API服务状态”

📦 安装

使用紫外线（推荐）

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.

幕后：

1. 用户呼叫 generate_prompt_song() 或 generate_custom_song()
2. MCP发送发电请求→ 接收2首歌曲ID
3. MCP自动轮询 /music/generate/query 每2秒
4. 当所有歌曲完成时（状态=1），返回下载URL
5. 默认超时：10分钟（可通过配置 TIME_OUT_SECONDS)

重要提示：

• ⏱️ 每首歌曲的生成通常需要2-5分钟
• 🔁 MCP服务器自动处理所有轮询
• 🎵 每一代人总是创作2首歌曲变体
• 💰 生成请求成功时扣除积分（5）
• ⚠️ 如果生成失败，则不会消耗积分

🐛 故障排除

常见问题

1. API密钥错误：确保 MUSICMCP_API_KEY 设置正确

- 使用 check_credit_balance 检查钥匙的工具

1. 学分不足（402错误）：你的学分不够

- 请在以下网址查看您的余额https://www.musicmcp.ai - 为您的帐户充值

1. 超时错误：增加 TIME_OUT_SECONDS 如果音乐生成需要更长的时间

日志

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

• 视窗: %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)

🔗 链接

• 平台: https://www.musicmcp.ai
• 文档: https://www.musicmcp.ai/docs
• 支持: support@musicmcp.ai

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

由以下材料制成❤️ 音乐MCP。AI团队

*使用AI将您的想法转化为音乐*