AniList MCP (Convex)

Serveur MCP personnel pour AniList. Convex expose le MCP à https://<déploiement>.convex.site/mcp — pas de process Node local, pas de backend OAuth.

AniList n’a qu’un endpoint GraphQL (https://graphql.anilist.co) et un grant implicite : tu crées un client, tu récupères un JWT valable un an, tu le poses en variable d’environnement Convex. C’est le raccourci mono-utilisateur.

Cinq outils

Outil	Rôle
chercher	Recherche un titre, rend l’id AniList et le nombre d’épisodes
ma_liste	Ta collection, filtrable par statut (CURRENT, PLANNING, …)
progression	SaveMediaListEntry avec progress — l’épisode que tu viens de voir
noter	SaveMediaListEntry avec score et status
en_cours_de_diffusion	Ce qui sort cette semaine parmi tes séries suivies

Le dernier utilise le calendrier AniList (airingAt), pas une liste tenue à la main. « Quoi regarder ce soir » devient l’épisode sorti aujourd’hui.

1. Convex

npm install
npx convex dev

Ça crée (ou relie) le projet sur ton compte Convex et pousse les fonctions. L’URL HTTP du site apparaît dans le dashboard (*.convex.site).

2. Jeton AniList (implicit grant)

1. anilist.co/settings/developer → Create New Client
2. Redirect URL : https://anilist.co/api/v2/oauth/pin (page PIN, aucun backend)
3. Ouvre :

https://anilist.co/api/v2/oauth/authorize?client_id=TON_CLIENT_ID&response_type=token

4. Copie le JWT, puis :

npx convex env set ANILIST_TOKEN 'eyJ...'
npx convex env set ANILIST_TIMEZONE Europe/Paris

Optionnel, pour verrouiller POST /mcp :

npx convex env set MCP_SECRET 'un-secret-long'

3. Cursor

Dans ~/.cursor/mcp.json (ou Settings → MCP) :

{
  "mcpServers": {
    "anilist": {
      "url": "https://VOTRE_DEPLOIEMENT.convex.site/mcp"
    }
  }
}

Si MCP_SECRET est défini :

{
  "mcpServers": {
    "anilist": {
      "url": "https://VOTRE_DEPLOIEMENT.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer un-secret-long"
      }
    }
  }
}

Le transport est Streamable HTTP, sans session persistante (spec récente). Convex reste l’hôte.

Exemples

• « Cherche Frieren » → chercher → id + 28 épisodes
• « Marque l’épisode 12 de Frieren » → progression
• « Note 85 et COMPLETED » → noter
• « Qu’est-ce qui sort ce soir dans ma liste ? » → en_cours_de_diffusion

Dev

npm test
npm run lint
npx convex dev          # watch + push (dev uniquement)

npx convex deploy uniquement pour la prod.

Les appels AniList sont des actions Convex (convex/anilist.ts). Le routeur HTTP (convex/http.ts) traduit JSON-RPC MCP → ces actions.