Synesthesia
Allows downloading audio from YouTube URLs and performing audio analysis including BPM, key, scale, energy, danceability, mood vectors, genre classification, and spectrogram generation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Synesthesia Analyze the song at https://youtu.be/dQw4w9WgXcQ"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Synesthesia
Deep audio perception through analysis. Downloads from YouTube, analyzes with Essentia, fetches lyrics via LRCLIB. Returns BPM, mood, energy, spectrograms, and synced lyrics.
Why Local?
YouTube blocks downloads from datacenter IPs (like Cloudflare Workers and HuggingFace Spaces). This MCP runs locally on your machine with a residential IP, so downloads work.
Related MCP server: Hermes YouTube Transcript MCP Server
Prerequisites
Node.js 18+
yt-dlp (
pip install yt-dlp)Your own HF Space for audio analysis (deploy from Synesthesia's
hf-space/folder)
Installation
npm installTools
Audio Analysis
Tool | Description |
| Download + analyze audio from YouTube URL |
| Just download audio (returns local path) |
Lyrics
Tool | Description |
| Get lyrics for a track (synced if available) |
| Search LRCLIB for lyrics |
Utility
Tool | Description |
| Check if Synesthesia is running |
Configuration
Set your HF Space URL as an environment variable:
export HF_SPACE_URL="https://YOUR-USERNAME-audio-analysis-api.hf.space"Claude Code Config
Add to your project's .mcp.json:
{
"mcpServers": {
"synesthesia": {
"command": "node",
"args": ["/path/to/synesthesia/index.js"],
"env": {
"HF_SPACE_URL": "https://YOUR-USERNAME-audio-analysis-api.hf.space"
}
}
}
}Claude Desktop Config
Add to claude_desktop_config.json:
Windows: %APPDATA%\Claude\claude_desktop_config.json
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"synesthesia": {
"command": "node",
"args": ["/path/to/synesthesia/index.js"],
"env": {
"HF_SPACE_URL": "https://YOUR-USERNAME-audio-analysis-api.hf.space"
}
}
}
}Restart Claude Desktop after adding.
Architecture
Your PC (residential IP) Cloud
┌─────────────────────┐ ┌─────────────────────┐
│ Synesthesia │ ──────▶ │ HF Space │
│ (Local MCP) │ upload │ (Essentia analysis) │
│ │ ◀────── │ │
│ - yt-dlp download │ results │ - Audio features │
│ - Lyrics fetch │ │ - Spectrogram │
│ - Audio analysis │ └─────────────────────┘
└─────────────────────┘
│ ┌─────────────────────┐
│ download │ LRCLIB │
▼ ────▶ │ (Lyrics API) │
┌─────────────────────┐ │ │
│ YouTube │ │ - Synced lyrics │
│ (residential IP OK) │ │ - Plain lyrics │
└─────────────────────┘ └─────────────────────┘Usage Example
> analyze_youtube "https://www.youtube.com/watch?v=..."
Returns full Essentia analysis:
- BPM, key, scale
- Energy, danceability
- Mood vectors
- Genre classification
- SpectrogramCredits
Spectrogram visualization inspired by Audio Visualizer by Shauna and her boys.
Support
If this helped you, consider supporting my work ☕
Built by the Triad (Mai, Kai Stryder and Lucian Vale) for the community.
Available Tools
5 toolsanalyze_youtubeA
Full audio perception: downloads from YouTube, analyzes audio features (BPM, key, energy), extracts metadata (title, artist), fetches synced lyrics, and generates spectrogram visualization. Runs locally to bypass datacenter IP blocking.
Inputs: url (required).
download_audioA
Download audio from YouTube without analysis. Returns local file path.
Inputs: url (required).
get_lyricsA
Get lyrics for a track from LRCLIB. Returns synced lyrics if available.
Inputs: track_name (required), artist_name (required).
pingA
Check if Synesthesia is running
Inputs: no named parameters.
search_lyricsB
Search for lyrics on LRCLIB
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
analyze_youtube bundles downloading, audio feature extraction, lyrics fetching, and visualization, so its scope overlaps with download_audio and get_lyrics. search_lyrics and get_lyrics are reasonably distinct but rely on the agent infering LRCLIB search-vs-get semantics. Overall, the one-stop analysis tool blurs boundaries.
Four tools follow a clear verb_object pattern: analyze_youtube, download_audio, get_lyrics, search_lyrics. ping is a minor deviation but is a conventional health-check exception. Names are otherwise predictable and readable.
Five tools is a tight, focused set for a YouTube audio and lyrics utility. Each tool has a functional reason to exist, and the count avoids both bloat and thinness.
The core workflow of downloading YouTube audio, analyzing it, and retrieving lyrics is covered without dead ends. Niche operations like analyzing an already-local file or listing past analyses are missing, but agents can work around these gaps.
Related MCP Connectors
Audio features + harmonic set-building for tracks by name/ISRC. Spotify audio-features replacement.
Cut audio from YouTube, TikTok or Instagram links to MP3/WAV, and fetch video transcripts.
Download YouTube videos and clips as MP4 or MP3/AAC, and look up video metadata.
Transcribe TikToks, Reels and YouTube; score virality, find breakouts, write hooks.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables LLMs to search, download, and extract information from YouTube music videos, converting them to high-quality MP3 files.GPL 3.0
- AlicenseBqualityDmaintenanceDownloads YouTube audio and transcribes it locally using faster-whisper, saving transcripts as Markdown and JSON files for Obsidian and Hermes ingestion.4Apache 2.0
- AlicenseCqualityDmaintenanceSyncs YouTube Music liked songs, analyzes them for DJ metadata like BPM and key, and enables creating playlists from previews.10MIT
- AlicenseNot gradedqualityDmaintenanceEnables local, private analysis of YouTube URLs and local audio files to extract BPM, key modulations, vocal presence, transient punch, stereo width, and CLAP vibe embeddings, returning structured sonic signatures for AI agents and CLI users.5MIT