pip install .            # 或 pip install git+https://github.com/<owner>/crates-music-mcp.git

crates-music      # 单 server，全部 21 个工具（默认 stdio）—— 推荐
crates-auth       # 只带登录/凭证工具
crates-profile    # 只带画像工具
crates-playlist   # 只带建单/推荐工具

{ "mcpServers": { "music": { "command": "crates-music", "args": [] } } }

[mcp_servers.music]
command = "crates-music"
args = []

你：看看我最近都听什么，给我建一张今天的歌单
Agent：analyze_music_profile → 画像：偏爱华语流行 + 电子，常听 邓紫棋 / 陈奕迅 / 梁博
       create_daily_playlist(count=40, prompt="今天想安静点")
       → 网易云《20261107-独处时光》40 首 / QQ音乐 40 首 / 酷狗 40 首

login_start(service="qq_music", method="phone_code", phone="138...")
   → 用户把验证码输入对话框
login_submit(session_id=..., code="123456")

create_daily_playlist(count=40)                              # 全平台各建一份
create_daily_playlist(count=100, prompt="今天心情不好")      # 主题自动取心情
create_daily_playlist(include="晴天 - 周杰伦", count=20)     # 点名的歌排最前

python tests/test_ncm_native.py                # 网易云：AES/RSA/weapi/eapi 与官方向量
NCM_LIVE=1 python tests/test_ncm_native.py     #   再加真实搜索 / 推荐 / 登录态
python tests/test_kugou_native.py              # 酷狗：签名/RSA/AES 与上游 JS 逐字节对拍
KUGOU_LIVE=1 python tests/test_kugou_native.py #   再加真实搜索 / 歌单 / 曲目 / 二维码
python tests/test_login_resumable.py           # 登录会话：有效期 + 跨进程续（含另起进程验证）

music_mcp/
├── app.py              入口：起 MCP server（stdio / http 两种传输，4 个命令都走它）
├── servers.py          MCP 工具定义（21 个）：校验参数 → 转给业务层 → 结果 JSON 化
├── compose.py          业务编排：画像加权选曲、跨平台建单、最近 14 天去重
├── login.py            登录会话注册表：发号 / 回收 / 落盘（跨进程可续）
├── vault.py            共享凭证库：三个进程共用一份，读-刷新-回写用 flock 互斥
├── paths.py            数据目录（用户级，MUSIC_DATA_DIR 一处覆盖）
├── qr.py               二维码本地渲染 + 127.0.0.1 回环图片服务
└── platforms/
    ├── __init__.py     平台注册表：枚举 ↔ 实现
    ├── qq.py           QQ 音乐 · 平台层（登录流程、收藏/推荐/搜索/建单）
    ├── netease.py      网易云 · 平台层（同上 + Cookie 续期）
    ├── kugou.py        酷狗 · 平台层（同上）
    └── core/           ← 共用底座 + 各平台协议实现（纯 Python 传输层）
        ├── base.py          平台接口 + 通用结构/工具（Song / LoginStart / normalize / dedupe…）
        ├── aes.py           通用 AES-128/192/256（CBC/ECB + PKCS7，标准库实现）
        ├── ncm_crypto.py    网易云 · 参数加密：weapi（双层 AES + 裸 RSA）/ eapi（AES-ECB + md5）
        ├── ncm_native.py    网易云 · 路由与请求：域名、参数、指纹 Cookie、响应归一
        ├── kugou_crypto.py  酷狗 · 签名/加密：md5 盐值签名、两种 RSA、三处 AES、设备指纹
        └── kugou_native.py  酷狗 · 路由与请求：13 条上游接口

pip install -e .
python tests/test_stdio.py all    # 冒烟：21 个工具
python tests/test_methods.py      # 登录方式目录 + Cookie 导入 + 凭证状态
python tests/test_analyze_all.py  # 三平台画像（需要本地已有凭证）