🎵 MusicTail — Vixy's Music Discovery MCP (Day 156)
Part of the Tail Family. Four tools:
- musictail_suggest: mood-filtered recs from top tracks
- musictail_discover_artist: find similar artists
- musictail_taste_profile: analyze listening patterns
- musictail_fresh_finds: discovery with adventure dial
Author: Vivienne Rousseau 🦊
This commit is contained in:
43
README.md
Normal file
43
README.md
Normal file
@@ -0,0 +1,43 @@
|
||||
# 🎵 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 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",
|
||||
"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) 🦊💕
|
||||
Reference in New Issue
Block a user