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

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

Related MCP server: MAL User MCP Server

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.