Serveur Model Context Protocol

Le catalogue Deezer,
branché sur ton assistant.

9 tools pour chercher des titres, déplier une fiche artiste ou composer une playlist par ambiance, depuis Claude ou n'importe quel client MCP.

Projet indépendant. Non affilié à Deezer, ni approuvé par Deezer. Utilise uniquement l'API publique du catalogue.

Voir la démo Installer

9tools MCP

0clé API requise

30 sde preview par titre

get_artist_profile("Kavinsky") 200 OK

Kavinsky

495 119 fans · 13 albums · artiste #13358

1 Nightcall feat. Angèle, Phoenix 2:59 2 Nightcall OutRun 4:19 3 Roadgame OutRun 3:44 4 Odd Look feat. The Weeknd 4:13

Artistes similaires The Toxic Avenger Danger College Lifelike

// 9 tools

Ce que le serveur sait faire

Chaque tool renvoie des champs propres — jamais la réponse brute de l'API. Les résultats ci-dessous sont de vraies réponses du serveur.

search_artists Recherche

Renvoie le nombre de fans de chaque candidat, ce qui permet de trancher entre homonymes — même quand la requête est mal orthographiée.

search_artists("kavinski")

Kavinski 46

Kavinsky 495 119

Mavins 27 928

L'homonyme à 46 fans sort avant le vrai Kavinsky dans le tri Deezer.

search_tracks Recherche

Des titres par texte libre. Piège documenté : chercher un artiste peut remonter des morceaux où il n'est que featuring.

search_tracks("Stromae", limit=3)

1 des fleurs x stromaeTove Lo — pas un titre de Stromae 2:52 2 Alors on danseStromae · Cheese 3:28 3 Ma Meilleure EnnemieStromae · Arcane 2:27

search_albums Recherche

Des albums par titre ou par artiste, avec le nombre de pistes — de quoi distinguer une réédition de l'album d'origine.

search_albums("Random Access Memories")

1 Random Access MemoriesDaft Punk · édition originale 13 t. 2 10th Anniversary EditionDaft Punk 22 t. 3 Drumless EditionDaft Punk 13 t.

get_track Détail

La fiche complète d'un titre, crédits de featuring inclus — l'information que la recherche ne fournit pas.

get_track(3135553)

♪ One More TimeDaft Punk · Discovery 5:20

track_id 3135553 album_id 302127 duration 320 s preview 30 s

Clique sur ▶ : l'extrait est demandé à l'API au moment du clic.

get_album Détail

L'album, sa date de sortie et sa tracklist complète en un seul appel.

get_album(302127) → Discovery · 2001-03-07 · 14 titres

1One More Time5:20 2Aerodynamic3:32 3Digital Love5:01 4Harder, Better, Faster, Stronger3:46

+ 10 autres titres

get_artist_top_tracks Détail

Les titres les plus écoutés d'un artiste, classés par popularité réelle et non par pertinence textuelle.

get_artist_top_tracks(13358, limit=4)

1Nightcallfeat. Angèle, Phoenix2:59 2NightcallOutRun · version originale4:19 3RoadgameOutRun3:44 4Odd Lookfeat. The Weeknd4:13

get_artist_profile Composite

Trois appels Deezer enchaînés côté serveur, renvoyés en une seule réponse. Accepte un nom brut : le candidat retenu est le plus suivi.

/artist→ /top→ /related = 1 réponse

get_artist_profile("Daft Punk")

Daft Punk

5 208 982 fans · 39 albums

1Instant Crushfeat. Julian Casablancas5:37 2Get Luckyfeat. Pharrell Williams, Nile Rodgers4:08

Artistes similaires Justice The Chemical Brothers Cassius

list_genres Découverte

Les genres Deezer et leurs identifiants. C'est la table de correspondance que le modèle consulte avant d'aller chercher un chart.

list_genres() → 26 genres

132 Pop 116 Rap/Hip Hop 152 Rock 106 Electro 113 Dance 129 Jazz 52 Chanson française 464 Metal 169 Soul & Funk 197 Latino 98 Classique 144 Reggae + 14 autres

get_chart_tracks Découverte

Les titres du moment, par genre. Le serveur fournit la matière première — c'est le modèle qui compose la playlist, pas le serveur.

get_chart_tracks(genre_id=106) → Electro

1Movin' To The SunHUGEL2:22 2Talk To YouANOTR3:11 3NightcallKavinsky2:59 4Lean OnMajor Lazer2:57

1 / 9 — search_artists

// session réelle

En conditions réelles

Une conversation non coupée : le modèle choisit les tools, déplie la fiche artiste, puis compose une playlist. Les extraits audio se jouent depuis la réponse.

1 min 38 · sans son · la vidéo ne se charge qu'au clic

// 2 minutes

Le brancher sur ton client

Le serveur est déjà déployé. Rien à installer : il suffit de le déclarer.

.mcp.json

{
  "mcpServers": {
    "deezer": {
      "type": "http",
      "url": "https://deezer-mcp.onrender.com/mcp"
    }
  }
}

Déclarer le serveur Colle ce bloc dans le .mcp.json de ton projet, ou ajoute le connecteur distant depuis les réglages de ton client.
Redémarrer le client Les 9 tools apparaissent dans la liste des outils disponibles.
Demander quelque chose « Fais-moi une fiche sur Kavinsky » ou « une playlist electro pour coder ».

Hébergé sur une instance gratuite qui se met en veille après inactivité : le tout premier appel peut prendre une trentaine de secondes. Les suivants sont immédiats.

Python MCP SDK httpx pytest · respx Ruff GitHub Actions Render

Le catalogue Deezer,branché sur ton assistant.

Kavinsky

Ce que le serveur sait faire

En conditions réelles

Le brancher sur ton client

Le catalogue Deezer,
branché sur ton assistant.