内容
-deezer
向 AI 代理的 Dee 服务器。29 种工具可用于搜索、管理播放列表、收藏和。适用于免费 Deezer 账户，无需开发者应用程序。
[](LICENSE)
[ 于 2025 年。不再支持新的 OAuth 应用程序 密钥。该服务器使用浏览 cookie（ARL）代替，无需注册，即可## 面向 AI 代理指南
如果您是 AI，正在为用户安装 `mcp-deezer`，请按照以下步骤进行：
### 步骤 1：检查先决- 必须安装 Python 3.12+（使用 ` --version` 或 `python --version`）
- 如果未安装 https://www.python.org/downloads/ 安装
### 步骤 2：安装软件包
```bash
pip install mcp-deezer
```
或使用 uvx（无需持久安装）：
```bash
uvcp-deezer
```
### 步骤 3：获取用户的 DeeRL cookie
用户手动执行此操作1. 访问 https://dee 并登录
2. 按 F12 → 应用程序 → Cookiedeezer.com`
3. 找到名为 `arl` 的 cookie 并复制其值（约 192 个字符的十六进制字符串）
ARL 类似：`a1b2c3d4e5f6...`（192 个十六进制字符）
### 步骤 4：配置 MCP 服务器
将以下内容添加到用户的 MCP 客户端配置中。`DEEZER_ARL` 环境变量是**必需的**。
**Claude Desktop** — `claude_desktop_config.json`：
```json
{
"mcpServers": {
"deezer": {
command": "uv "args":cp-deezer"],
"env": {
"DE_ARL": "PASTE_HERE"
}
}
}
```
**Claude Code** — 终端：
```bash
mcp add deee DEEZER_ARL=PASTE_ARL_HEREx mcp-deezer**Cursor** — `.cursor.json`：
```json "mcpServers": {
"deezer": {
"command": "uvx",
"args": ["mcp-de"],
"env": {
"DEEZER_ARLPASTE_ARL_HERE }
}
}
}
Hermes Agent** — `~/.hermes/config.yamlyaml
mcp_servers:
deezer:
command: uvx
args: [mcp-deezer]
DEEZER_ARL: "PASTE_ARL_HERE"
```
**VS Code / Cop — `.vscode/mcp：
```json
{
servers": {
"dee {
"command": "uvx",
"args":cp-deezer"],
"env": {
"DE_ARL": "PASTE_ARL_HERE"
}
}
}
}
```
### 5：重启 MCP 告诉用户重启他们的 AI Claude Desktop、Cursor 等服务器。
### ：验证
调用 `` — 它应该返回用户的 Deezer 配置文件 ID。如果它 `DEEZER_AR 的错误，则 cookie 已过期。
## 可用工具）
| 工具 | |
|---|---| `get_me` | 用户 ✅ |
| `search` | 搜索曲目、专艺术家、播放列表 |
| `get_track`目详情与歌 ✅ |
| `get_ | 艺术家简介 | ✅ |
| `` | 专辑详情与列表 | ✅ |
|_playlist` | 详情与曲目 | ✅ `get_charts` | 国家排行榜（法国、美国...） | ✅ |
| `get_similar_tracks` | 相似曲目 | ✅ |
| `get_similar_artists` | | ✅ |
| `get_flow` | 个人 Deezer 流媒体 | ✅ |
| `get_recommendations` | 个性化推荐 | ✅ |
| `get_recently_played` | 收听历史 | ✅ |
| `get_user_charts` | 个人热门曲目/艺术家 | ✅ |
| `get_favorite_tracks` | 喜欢的曲 ✅ |
| `get_favorite_albums`喜欢的专辑 |
| `_artists` | 艺术家 | ✅ |
| `get_favorite_playlists` | 喜欢的播放列表 | ✅ |
| `add_track_to_favorite` | 喜欢曲目 |
| `remove_track_from_favorite` | 不喜欢 | ✅ |
| `add_favorite` | 喜欢专辑 | ✅ |
| `remove_album_from_favorite` |专辑 | ✅ |
add_artist_to_favorite 关注艺术家 | ✅ |
| `remove_artist_from_favorite` | 取消 | ✅ |
| `_playlists` | 用户播放列表 | ✅ |
| `list` | 创建播放 ✅ |
| `update_playlist 更新播放列表标题 | ✅ |
| `list` | 删除播放列表 | ✅ `add_trackslist` | 添加曲目到播放列表 | ✅ |
remove_tracks_from_playlist` | 从播放列表中删除曲 ✅ |
## 工作原理
代理 ←── MCP（stdio）──→ mcp-dee── GraphQL→ Deezer API
│
ARL cookie（您的会话使用 [`deezer-python-gql`](https://github.comistant/deezer-python-gql) — Deezer GraphQL API 的非官方客户端。认证通过存储中的 ARL cookie 进行。
## 常见问题（针对代理**问：用户的 停止工作了。：告诉他们退出登录到 deezer.com新的 `arl` cookie问：这是否适用于免费 Deezer 账户？**
答：是的。与 Spotify 不同，Deezer账户。
**问：违反 Deezer 的服务**
答：它 Deezer 网页播放 API。您的账户、、您的会话 cookie。
**问：Python 3+ 无法使用。：从 https://www/downloads/ 安装它，或自己的 Python 的 ``。
## 许可证
MIT
