Is Yourmusic Mcp safe to install?

SaferSkills independently audited Yourmusic Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

README.md · 1 file

README.md10.8 KB · Markdown

🎵 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.

</div>

✨ 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
✅ API Key Validation: Check your API key validity and remaining credits
🏥 Health Monitoring: Check API service health status
📊 API Information: Get detailed information about available endpoints and costs

🚀 Quickstart with Claude Desktop

Get Your API Key: Obtain your API key from MusicMCP.AI Platform
Install uv: Install the Python package manager with curl -LsSf https://astral.sh/uv/install.sh | sh
Configure Claude: Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json and add:

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

Restart Claude: Restart the Claude app and you'll see 5 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., "ambient", "pop", "rock")

Example Prompts:

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

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 Preview:
[Verse]
Gentle sunlight fills the room
Morning dew and sweet perfume...

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 Preview:
[Verse]
Calm and quiet, soft and still
Peaceful thoughts upon the hill...

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., 'pop', 'rock', 'folk')

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 Preview:
[Verse]
Walking through the summer fields
Golden wheat and nature's yields...

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 Preview:
[Verse]
Walking through the summer fields
Golden wheat and nature's yields...

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

3. ✅ Validate API Key

Check if your API key is valid and see your remaining credits.

Cost: Free

Example Usage:

"Validate my API key"
"Check my credit balance"

4. 🏥 Check API Health

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

Cost: Free

Example Usage:

"Check API service status"

5. 📊 Get API Info

Get detailed information about the API including rate limits and documentation.

Cost: Free

Example Usage:

"Get API information"

💰 Credits & 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)	-
Validate API Key	0 credits (Free)	-
API Health Check	0 credits (Free)	-
Get API Info	0 credits (Free)	-

💡 Example Usage

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

Try asking Claude:

#### Inspiration Mode:

"Please help me generate a song about a peaceful morning"
"Want a song that expresses longing"
"Create music about friendship"
"Generate an ambient music track"

#### Custom Mode:

"Please help me generate a song, Title: Summer Dreams, Lyrics: [complete lyrics], Style: folk"
"Create a song, Title: Spring Promise, Lyrics: [complete lyrics], Pop style"
"Generate an instrumental song, Title: Ocean Breeze, Style: ambient"

#### Management Functions:

"Validate my API key"
"Check how many credits I have left"
"Check API service status"

📦 Installation

Using uv (Recommended)

uvx aimusic-mcp

Using pip

pip install aimusic-mcp

From Source

git clone https://github.com/ai-music-repo/aimusic-mcp-tool.git
cd aimusic-mcp-tool
pip install -e .

Quick Install Script

chmod +x install.sh
./install.sh

🔌 API Integration

This MCP server integrates with MusicMCP.AI'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)
`POST /validate`: Validate API key and check credits
`GET /health`: Check API service health
`GET /info`: Get API information

🔄 Async API Workflow

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

Step 1: Submit Generation Request

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

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

Step 3: Return Complete Song Information

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

Behind the Scenes:

User calls generate_prompt_song() or generate_custom_song()
MCP sends generation request → receives 2 song IDs
MCP automatically polls /music/generate/query every 2 seconds
When all songs complete (status=1), returns download URLs
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

API Key Error: Ensure MUSICMCP_API_KEY is set correctly

Use the validate_api_key tool to check your key

Insufficient Credits (402 Error): You don't have enough credits

Check your balance at https://www.musicmcp.ai
Recharge your account

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

pytest tests/

Local Development

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
GitHub: https://github.com/ai-music-repo/aimusic-mcp-tool
Issues: https://github.com/ai-music-repo/aimusic-mcp-tool/issues

📄 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

</div>

Yourmusic Mcp— agent skill

Is Yourmusic Mcp safe to install?

🎵 MusicMCP.AI MCP Server

✨ Features

🚀 Quickstart with Claude Desktop

⚙️ Environment Variables

🛠️ Available Tools

1. 🎼 Generate Prompt Song (Inspiration Mode)

2. 🎵 Generate Custom Song (Custom Mode)

3. ✅ Validate API Key

4. 🏥 Check API Health

5. 📊 Get API Info

💰 Credits & Pricing

💡 Example Usage

Try asking Claude:

📦 Installation

Using uv (Recommended)

Using pip

From Source

Quick Install Script

🔌 API Integration

🔄 Async API Workflow

🐛 Troubleshooting

Common Issues

Logs

🧪 Development

Running Tests

Local Development

Code Structure

🔗 Links

📄 License

Audit the pieces. Scan the whole. Decide.