Aimusic MCP Tool

MCP音视频

提供方 未标注

音视频 HTTP · 远程 未标注 社区 / 第三方
查看接入方式

全面解析Aimusic MCP ToolMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器,Aimusic MCP Tool能让AI助手访问实时数据、执行操作,为您提供更智能的工作体验和自动化解决方案。

一句话选型结论

按资料字段整理

Aimusic MCP Tool 属于音视频类 MCP 服务器,HTTP · 远程,鉴权方式未标注,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类音视频 传输方式HTTP · 远程 鉴权未标注 部署方式远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

音视频
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

安装与配置

HTTP · 远程 未标注
连远程 HTTPS 端点,通常为 Streamable HTTP
pip install aimusic-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
转写与字幕

把音视频转成文字和字幕。

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在音视频场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Aimusic MCP Tool当前 未标注 HTTP · 远程 远程部署 有 2026-05-17
Ableton MCP B7b69a6a 16 stdio · 本地进程 本地部署 有 2026-05-17
Mini Max MCP 8 SSE · 服务端推送 远程部署 有 2026-05-18
LocalAI 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Youtube E0eb3510 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Voicemode MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

音视频
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类音视频本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.1 KB
来自项目仓库与上游目录的原文,未做删改

🎵 MusicMCP.AI MCP Server

AI-Powered Music Generation with Model Context Protocol

Official MusicMCP.AI Model Context Protocol (MCP) server that enables seamless interaction with our advanced AI music generation platform. This server allows MCP clients like Claude Desktop, OpenAI Agents and others to generate AI music through natural language commands.

✨ Features

  • 🎼 AI Music Generation: Generate songs based on text prompts using MusicMCP.AI's state-of-the-art AI models
  • 🎵 Dual Generation Modes: Support for both inspiration mode and custom mode
  • 🔗 Direct Download Links: Get direct download URLs for generated music
  • 🎹 Instrumental Options: Generate instrumental-only music or full songs with vocals
  • ✅ Credit Balance Check: Check your API key validity and remaining credits
  • 🏥 Health Monitoring: Check API service health status

🚀 Quickstart with Claude Desktop

  1. Get Your API Key: Obtain your API key from MusicMCP.AI Platform
  2. Install uv: Install the Python package manager with curl -LsSf https://astral.sh/uv/install.sh | sh
  3. Configure Claude: Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json and add:```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"
    }
    }
    }
    }

4. **Restart Claude**: Restart the Claude app and you&#x27;ll see **4 MCP tools** available, indicating successful loading

## ⚙️ Environment Variables

| Variable | Description | Default | Required |
|----------|-------------|---------|----------|
| `MUSICMCP_API_KEY` | Your MusicMCP.AI API key | - | ✅ Yes |
| `MUSICMCP_API_URL` | MusicMCP.AI API base URL | `https://www.musicmcp.ai/api` | ❌ No |
| `TIME_OUT_SECONDS` | Timeout for music generation in seconds | `600` (10 min) | ❌ No |

## 🛠️ Available Tools

### 1. 🎼 Generate Prompt Song (Inspiration Mode)
Generate AI music based on simple text descriptions. AI automatically creates title, lyrics, and style.

**Cost**: 5 credits per generation (creates 2 songs)

**Parameters:**
- `prompt` (str): Simple description of the music theme (1-1200 characters)
- `instrumental` (bool): Whether to generate instrumental music only
- `style` (str, optional): Music style (e.g., &quot;ambient&quot;, &quot;pop&quot;, &quot;rock&quot;)

**Example Prompts:**```
&quot;Help me generate a song about a peaceful morning&quot;
&quot;Want a song that expresses longing&quot;
&quot;Create music about friendship&quot;

Output Example:```
✅ 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. 🎵 Generate Custom Song (Custom Mode)
Generate AI music with specific lyrics, title, and style parameters that you provide.

**Cost**: 5 credits per generation (creates 2 songs)

**Parameters:**
- `title` (str): Song title (required)
- `instrumental` (bool): Whether to generate instrumental music only (required)
- `lyric` (str, optional): Complete lyrics content (not required when instrumental is true)
- `tags` (str, optional): Music style tags (e.g., &#x27;pop&#x27;, &#x27;rock&#x27;, &#x27;folk&#x27;)

**Example Usage:**```
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

Output Example:```
✅ 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. ✅ Check Credit Balance
Check if your API key is valid and see your remaining credits.

**Cost**: Free

**Example Usage:**```
&quot;Check my credit balance&quot;
&quot;How many credits do I have left?&quot;

4. 🏥 Check API Health

Monitor the health status of the MusicMCP.AI API service.

Cost: Free

Example Usage:```
"Check API service status"


## 💰 Credits &amp; Pricing

| Operation | Credits Cost | Output |
|-----------|-------------|--------|
| Generate Inspiration Music | 5 credits | 2 songs |
| Generate Custom Music | 5 credits | 2 songs |
| Query Music Status | 0 credits (Free) | - |
| Check Credit Balance | 0 credits (Free) | - |
| API Health Check | 0 credits (Free) | - |

## 💡 Example Usage

⚠️ **Note**: MusicMCP.AI credits are required to use the music generation tools.

### Try asking Claude:

#### **Inspiration Mode:**
- &quot;Please help me generate a song about a peaceful morning&quot;
- &quot;Want a song that expresses longing&quot;
- &quot;Create music about friendship&quot;
- &quot;Generate an ambient music track&quot;

#### **Custom Mode:**
- &quot;Please help me generate a song, Title: Summer Dreams, Lyrics: [complete lyrics], Style: folk&quot;
- &quot;Create a song, Title: Spring Promise, Lyrics: [complete lyrics], Pop style&quot;
- &quot;Generate an instrumental song, Title: Ocean Breeze, Style: ambient&quot;

#### **Management Functions:**
- &quot;Check my credit balance&quot;
- &quot;How many credits do I have left?&quot;
- &quot;Check API service status&quot;

## 📦 Installation

### Using uv (Recommended)```bash
uvx aimusic-mcp

Using pip```bash

pip install aimusic-mcp


## 🔌 API Integration

This MCP server integrates with MusicMCP.AI&#x27;s RESTful API:

- **`POST /music/generate/inspiration`**: Create music generation task (inspiration mode)
- **`POST /music/generate/custom`**: Create custom music generation task
- **`POST /music/generate/query`**: Query music status (batch query supported)
- **`GET /credit`**: Check credit balance
- **`GET /health`**: Check API service health

### 🔄 Async API Workflow

Music generation is **asynchronous**. The MCP server handles this automatically:

**Step 1: Submit Generation Request**```bash
POST /music/generate/inspiration or /music/generate/custom
→ Returns: {&quot;code&quot;: 200, &quot;data&quot;: {&quot;ids&quot;: [&quot;id1&quot;, &quot;id2&quot;]}}

Step 2: Automatic Polling (handled internally by MCP)```bash
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


**Step 3: Return Complete Song Information**```
Once all songs are completed, returns full details:
- songName, songUrl, imgUrl, duration, tags, etc.

Behind the Scenes:
1. User calls generate_prompt_song() or generate_custom_song()
2. MCP sends generation request → receives 2 song IDs
3. MCP automatically polls /music/generate/query every 2 seconds
4. When all songs complete (status=1), returns download URLs
5. Default timeout: 10 minutes (configurable via TIME_OUT_SECONDS)

Important Notes:
- ⏱️ Generation typically takes 2-5 minutes per song
- 🔁 The MCP server handles all polling automatically
- 🎵 Each generation always creates 2 song variations
- 💰 Credits (5) are deducted when generation request succeeds
- ⚠️ If generation fails, credits are NOT consumed

🐛 Troubleshooting

Common Issues

  1. API Key Error: Ensure MUSICMCP_API_KEY is set correctly
    - Use the check_credit_balance tool to check your key

  2. Insufficient Credits (402 Error): You don't have enough credits
    - Check your balance at https://www.musicmcp.ai
    - Recharge your account

  3. Timeout Errors: Increase TIME_OUT_SECONDS if music generation takes longer

Logs

When running with Claude Desktop, logs can be found at:

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

🧪 Development

Running Tests```bash

pytest tests/


### Local Development```bash
python -m musicmcp_ai_mcp.api

Code Structure```

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

🔗 Links

  • Platform: https://www.musicmcp.ai
  • Documentation: https://www.musicmcp.ai/docs
  • Support: support@musicmcp.ai

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❤️ by the MusicMCP.AI Team

Transform your ideas into music with AI

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Aimusic MCP Tool 怎么安装?

在客户端按下面的安装命令接入:pip install aimusic-mcp。装完在客户端配置里引用同一个包或端点。

Aimusic MCP Tool 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Aimusic MCP Tool 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Aimusic MCP Tool 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

Aimusic MCP Tool 能提供哪些能力?

资料显示能力标签包括 自然语言交互、Python、HTTP。具体工具清单以官方文档为准。

Aimusic MCP Tool 需要什么运行环境?

运行时为 Python;属于远程端点,不需要在本地装运行时。

Aimusic MCP Tool 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。