内容
<p align="center">
<img src="docs/demo.svg" alt="AUX演示 — 雨夜凌晨2点驾驶" width="920" />
</p>
<h1 align="center">AUX</h1>
<p align="center"><strong>为AI打造的Spotify。</strong><br/>不是遥控器，是会聊天的DJ。</p>
<p align="center">
<a href="https://github.com/brian-mwirigi/aux-mcp"><img alt="GitHub" src="https://img.shields.io/badge/github-brian--mwirigi%2Faux--mcp-1DB954?style=flat-square" /></a>
<img alt="npm" src="https://img.shields.io/badge/npx-spotify--aux-111?style=flat-square" />
<img alt="hooks" src="https://img.shields.io/badge/hooks-peak-ff2d55?style=flat-square" />
</p>
```bash
npx -y spotify-aux demo
npx -y spotify-aux login
```
然后在Cursor中：*“雨夜凌晨2点驾驶”* · *“嘲笑我的热门歌曲”* · *“开始自动DJ”*
---
## 60秒设置
1. [Spotify仪表盘](https://developer.spotify.com/dashboard) → 创建应用
2. 重定向URI（精确）：
```
http://127.0.0.1:7654/callback
```
（可选稍后嘲笑网站：还需添加`http://127.0.0.1:7656/`）
3. 安装和登录：
```bash
npm i -g spotify-aux
# 或：git clone … && npm i && npm run build
export SPOTIFY_CLIENT_ID=…
export SPOTIFY_CLIENT_SECRET=…
npx -y spotify-aux login
```
4. Cursor MCP配置：
```json
{
"mcpServers": {
"aux": {
"command": "npx",
"args": ["-y", "spotify-aux"],
"env": {
"SPOTIFY_CLIENT_ID": "your_id",
"SPOTIFY_CLIENT_SECRET": "your_secret"
}
}
}
}
```
从本地克隆中，将`command`/`args`指向`node` + `dist/server.js`。
---
## 峰值钩子
| 说这句话 | 会发生什么 |
|----------|----------------|
| *雨夜凌晨2点驾驶* | `vibe` — LLM发明搜索，目录DJ |
| *Spotify不会给我看的音乐* | `vibe` + `anti_algorithm` |
| *现在的DJ* | `context_vibe` — 时间 + 天气 |
| *继续播放* | `auto_dj_start` → `npx spotify-aux autodj` |
| *嘲笑我的周报* | `weekly_report` |
| *派对房间* | `party_room_create` + 朋友中继 |
| *嘲笑这个播放列表*（无Cursor） | `npx spotify-aux web` |
每个钩子都可以丢弃一个**ASCII卡**，用于截图。
### 与朋友一起派对
```bash
# 主机
npx -y spotify-aux party-host
# 隧道，例如cloudflared tunnel --url http://127.0.0.1:7655
# 所有人
export AUX_PARTY_RELAY=https://your-tunnel.example
```
然后`party_room_create` → 分享**代码** → 朋友`party_room_add` / `party_room_vote`。
### 嘲笑网站（无MCP）
```bash
npx -y spotify-aux web
# 打开 http://127.0.0.1:7656
```
---
## 完整工具地图
<details>
<summary><strong>峰值/病毒式</strong></summary>
`vibe` · `context_vibe` · `weekly_report` · `auto_dj_start` · `auto_dj_tick` · `auto_dj_stop` · `auto_dj_status` · `party_room_create` · `party_room_join` · `party_room_add` · `party_room_vote` · `party_room_play_winner` · `set_mood` · `adjust_playlist_vibe` · `roast_my_playlist` · `playlist_dna` · `aux_battle` · `blend_tastes` · `music_compatibility` · `whats_playing_story` · `party_*` · `record_taste_feedback` · `get_taste_memory` · `auth_status`
</details>
<details>
<summary><strong>Spotify覆盖</strong></summary>
搜索，浏览，播放，播放列表，库，个性化 — 完整的Web API表面，因此代理永远不会在任务中卡住。
</details>
---
## 命令行界面
```bash
npx -y spotify-aux # MCP服务器
npx -y spotify-aux login
npx -y spotify-aux status
npx -y spotify-aux autodj # 补充循环
npx -y spotify-aux party-host # 朋友中继 :7655
npx -y spotify-aux web # 嘲笑网站 :7656
npx -y spotify-aux demo
```
在`npm i -g spotify-aux`之后，二进制文件：`spotify-aux`和`aux-mcp`。
---
## 认证
| 流程 | 解锁 |
|------|---------|
| 客户端ID + 密钥 | 搜索/目录 |
| `npx spotify-aux login` | 播放，库，钩子，自动DJ |
令牌 → `~/.aux-mcp/`。高级 + 打开Spotify应用程序进行播放。
---
## 给它点赞。传递辅助。
[github.com/brian-mwirigi/aux-mcp](https://github.com/brian-mwirigi/aux-mcp)
MIT
