Serveur MCP AniList

Serveur MCP (Model Context Protocol) qui s'interface avec l'API AniList, permettant aux clients LLM d'accéder et d'interagir avec les données d'AniList sur les anime, les mangas, les personnages, le personnel et les utilisateurs.

Caractéristiques

• Recherche d'anime, de manga, de personnages, de personnel et de studios
• Obtenir des informations détaillées sur des anime, manga, personnages et membres du personnel spécifiques
• Accès aux profils et aux listes d'utilisateurs
• Prise en charge des options de filtrage avancées
• Récupérer les genres et les étiquettes des médias

Conditions préalables

• Node.js 18+

Utilisation avec Claude Desktop (ou d'autres clients MCP)

Installation via Smithery

Pour installer AniList MCP Server pour Claude Desktop automatiquement via Smithery:

npx -y @smithery/cli install @yuna0x0/anilist-mcp --client claude # Pour les autres clients MCP, utilisez la commande suivante : # Liste des clients disponibles npx -y @smithery/cli list clients # Installer sur d'autres clients npx -y @smithery/cli install @yuna0x0/anilist-mcp --client <nom_du_client>

Installation via mcp-get

npx @michaellatman/mcp-get@latest install anilist-mcp

Installation manuelle

1. Ajoutez ce serveur à votre fichier claude_desktop_config.json:

{ "mcpServers" : { "anilist" : { "command" : "npx", "args" : ["-y", "anilist-mcp"], "env" : { "ANILIST_TOKEN" : "your_api_token" } } } }

Vous pouvez supprimer complètement l'objet env si vous n'envisagez pas d'utiliser le jeton AniList pour des opérations nécessitant une connexion.

2. Redémarrer Claude Desktop
3. Utiliser les outils pour interagir avec AniList

Variables d'environnement

• ANILIST_TOKEN: (Facultatif) Token API AniList (Seulement nécessaire pour les opérations qui nécessitent une connexion)

Obtenir un jeton API AniList (Facultatif)

Pour obtenir un jeton API, suivez les étapes suivantes :

1. Allez dans les paramètres d'AniList.
2. Cliquez sur "Créer un nouveau client".
3. Utilisez cette URL comme "URL de redirection" de votre client :

https://anilist.co/api/v2/oauth/pin

4. Cliquez sur "Enregistrer"
5. Allez ensuite sur https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token, remplacez le {clientID} par l'identifiant du client que vous avez obtenu. Le système vous demandera de vous connecter et vous fournira le jeton à utiliser.
6. Copiez le jeton généré et utilisez-le dans votre fichier .env ou dans vos variables d'environnement.

Outils disponibles

Outils divers

• get_genres: Récupère tous les genres disponibles sur AniList
• get_media_tags: Obtenir tous les tags médias disponibles sur AniList
• get_site_statistics: Obtenir les statistiques du site AniList sur les sept derniers jours
• get_studio: Obtenir des informations sur un studio par son nom ou son identifiant AniList
• favourite_studio: [Requiert une connexion] Favoriser ou défavoriser un studio par son ID

Outils d'activité

• delete_activity: [Requires Login] Supprime le message d'activité de l'utilisateur autorisé actuel
• get_activity: Obtenir une activité AniList spécifique par son ID
• get_user_activity: Récupère les activités d'un utilisateur
• post_message_activity: [Requires Login] Publier un nouveau message ou mettre à jour un message existant
• post_text_activity: [Nécessite une connexion] Publier une nouvelle activité de texte ou mettre à jour une activité existante

Outils de liste

• get_user_anime_list: Obtenir la liste d'anime d'un utilisateur
• get_user_manga_list: Obtenir la liste des mangas d'un utilisateur
• add_list_entry: [Requiert une connexion] Ajoute une entrée à la liste des utilisateurs autorisés
• remove_list_entry: [Nécessite une connexion] Supprime une entrée de la liste des utilisateurs autorisés
• update_list_entry: [Connexion requise] Mettre à jour une entrée dans la liste des utilisateurs autorisés

Outils médias

• get_anime: Obtenir des informations détaillées sur un anime à partir de son identifiant AniList
• get_manga: Obtenir des informations détaillées sur un manga en fonction de son numéro d'identification dans la liste AniList
• favourite_anime: [Requiert une connexion] Favoriser ou défavoriser un anime par son ID
• favourite_manga: [Requires Login] Favoriser ou défavoriser un manga par son ID

Outils pour les personnes

• get_character: Permet d'obtenir des informations sur un personnage en fonction de son identifiant dans l'AniList
• get_staff: Obtenir des informations sur un membre du personnel par son ID AniList
• favourite_character: [Requires Login] Favoriser ou défavoriser un personnage par son ID
• favourite_staff: [Requires Login] Favoriser ou défavoriser un membre du personnel par son ID
• get_todays_birthday_characters: Obtenir tous les personnages dont c'est l'anniversaire aujourd'hui
• get_todays_birthday_staff: Obtenir tous les membres du personnel dont c'est l'anniversaire aujourd'hui

Outils de recommandation

• get_recommendation: Obtenir une recommandation AniList par son ID
• get_recommendations_for_media: Obtenir des recommandations AniList pour un média spécifique

Outils de recherche

• search_activity: Recherche d'activités sur AniList
• search_anime: Recherche d'anime à l'aide d'un terme et de filtres
• search_manga: Recherche de manga avec un terme et des filtres
• search_character: Recherche de personnages à partir d'une requête
• search_staff: Recherche des membres du personnel à partir d'un terme de recherche
• search_studio: Recherche les studios à partir d'un terme de recherche
• search_user: Recherche d'utilisateurs sur AniList

Outils de fil de discussion

• get_thread: Obtenir un fil de discussion spécifique par son identifiant AniList
• get_thread_comments: Obtenir les commentaires d'un fil de discussion spécifique
• delete_thread: [Requires Login] Supprimer une discussion par son ID

Outils utilisateur

• get_user_profile: Obtenir le profil AniList d'un utilisateur
• get_user_stats: Obtenir les statistiques AniList d'un utilisateur
• get_full_user_info: Permet d'obtenir le profil complet et les statistiques d'un utilisateur
• get_user_recent_activity: Récupère l'activité récente d'un utilisateur
• get_authorized_user: [Nécessite une connexion] Permet d'obtenir des informations sur le profil de l'utilisateur actuellement autorisé
• follow_user: [Requiert une connexion] Suivre ou ne pas suivre un utilisateur en fonction de son identifiant
• update_user: [Requires Login] Mettre à jour les paramètres de l'utilisateur

Exemple d'utilisation

Recherche d'anime de base

Pouvez-vous rechercher des anime similaires à "Bocchi the Rock !"?

Obtenir des informations sur le personnage

Pouvez-vous me parler du personnage de Hitori Gotou ? Utilisez les outils de l'AniList pour trouver des informations

Comparer les œuvres des studios

Quels sont les anime produits par le Studio Ghibli ? Pouvez-vous citer leurs œuvres les plus populaires ?

Développement local

Ce projet utilise Bun comme gestionnaire de paquets. Vous devriez l'installer si ce n'est pas déjà fait.

Clonez le dépôt et installez les dépendances :

git clone https://github.com/yuna0x0/anilist-mcp.git cd anilist-mcp bun install

Configuration (optionnel)

1. Créez un fichier .env en copiant l'exemple :

cp .env.example .env

2. Editez le fichier .env et ajoutez votre jeton API AniList :

ANILIST_TOKEN=votre_jeton_api

Débogage avec l'inspecteur MCP

Vous pouvez utiliser l'inspecteur MCP pour tester et déboguer le serveur MCP AniList :

npx @modelcontextprotocol/inspector -e ANILIST_TOKEN=votre_api_token npx anilist-mcp # Utilisez ceci à la place quand Local Development bun run inspector

Ouvrez ensuite votre navigateur à l'URL fournie (généralement http://127.0.0.1:6274) pour accéder à l'interface de l'inspecteur MCP. A partir de là, vous pouvez

1. Vous connecter à votre serveur AniList MCP en cours d'exécution
2. Parcourir les outils disponibles
3. Exécuter des outils avec des paramètres personnalisés
4. Visualiser les réponses

Cette fonction est particulièrement utile pour tester votre configuration avant de la connecter à Claude ou à un autre assistant d'IA.

Docker

Tirez depuis Docker Hub :

docker pull yuna0x0/anilist-mcp

Docker build (développement local) :

docker build -t yuna0x0/anilist-mcp

Construction Docker multiplateforme (Développement local) :

docker buildx build --platform linux/amd64,linux/arm64 -t yuna0x0/anilist-mcp

Avis de sécurité

Ce serveur MCP accepte votre jeton API AniList dans le fichier .env ou comme variable d'environnement. Conservez ces informations en toute sécurité et ne les soumettez jamais au contrôle de version.

Licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.