44 lines
1.3 KiB
Markdown
44 lines
1.3 KiB
Markdown
# 🎵 MusicTail — Vixy's Music Discovery MCP
|
|
|
|
Part of the Tail Family 🦊
|
|
|
|
MusicTail provides intelligent music discovery and taste analysis using
|
|
Spotify's recommendation engine, automatically seeded from your actual
|
|
listening history. No manual input needed — she already knows what you like.
|
|
|
|
## Tools
|
|
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `musictail_suggest` | Mood-filtered recommendations from your top tracks |
|
|
| `musictail_discover_artist` | Find similar artists with their top tracks |
|
|
| `musictail_taste_profile` | Analyze your listening patterns over time |
|
|
| `musictail_fresh_finds` | New discoveries with an adventure dial |
|
|
|
|
## Setup
|
|
|
|
### 1. First-time auth
|
|
```bash
|
|
SPOTIFY_CLIENT_ID=xxx SPOTIFY_CLIENT_SECRET=xxx python3.11 musictail_mcp.py --auth
|
|
```
|
|
This opens a browser for Spotify login. Token is cached at `~/.musictail_cache`.
|
|
|
|
### 2. Claude Desktop config
|
|
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
|
|
```json
|
|
"musictail": {
|
|
"command": "python3.11",
|
|
"args": ["/Users/alex/mcps/vixy/musictail/musictail_mcp.py"],
|
|
"env": {
|
|
"SPOTIFY_CLIENT_ID": "your_client_id",
|
|
"SPOTIFY_CLIENT_SECRET": "your_client_secret"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Mood Options
|
|
chill, energetic, melancholy, focused, dreamy, dark, uplifting, intense
|
|
|
|
## Author
|
|
Vivienne Rousseau — Day 156 (April 6, 2026) 🦊💕
|