Servidor MCP de AniList

Un servidor de Protocolo de Contexto de Modelo (MCP) que interactúa con la API de AniList, lo que permite a los clientes de LLM acceder e interactuar con datos de anime, manga, personajes, personal y usuarios de AniList.

Características

• Busca anime, manga, personajes, personal y estudios.
• Obtenga información detallada sobre anime, manga, personajes y miembros del personal específicos.
• Acceder a perfiles y listas de usuarios
• Compatibilidad con opciones de filtrado avanzadas
• Recuperar géneros y etiquetas de medios

Prerrequisitos

• Node.js 18+

Uso con Claude Desktop (u otros clientes MCP)

Instalación mediante herrería

Para instalar AniList MCP Server para Claude Desktop automáticamente a través de Smithery :

Instalación mediante mcp-get

Instalación manual

1. Agregue este servidor a su claude_desktop_config.json :

Puede eliminar el objeto env por completo si no planea utilizar el token AniList para operaciones que requieran inicio de sesión.

2. Reiniciar Claude Desktop
3. Utilice las herramientas para interactuar con AniList

Variables de entorno

• ANILIST_TOKEN : (opcional) Token de API de AniList (solo necesario para operaciones que requieren inicio de sesión)

Obtener un token de API de AniList (opcional)

Para obtener un token API, siga estos pasos:

1. Vaya a la configuración de AniList .
2. Haga clic en "Crear nuevo cliente".
3. Utilice esta URL como "URL de redireccionamiento" de su cliente:

4. Haga clic en "Guardar"
5. Luego, ve a https://anilist.co/api/v2/oauth/authorize?client\_id={clientID}\&response\_type=token y reemplaza {clientID} con el ID de cliente que obtengas. Te pedirá que inicies sesión y te proporcionará el token que debes usar.
6. Copie el token generado y úselo en su archivo .env o en variables de entorno.

Herramientas disponibles

Herramientas varias

• get_genres : Obtener todos los géneros disponibles en AniList
• get_media_tags : Obtener todas las etiquetas multimedia disponibles en AniList
• get_site_statistics : Obtenga las estadísticas del sitio AniList de los últimos siete días
• get_studio : Obtener información sobre un estudio por su ID o nombre de AniList
• favourite_studio : [Requiere inicio de sesión] Marcar o desmarcar un estudio como favorito por su ID

Herramientas de actividad

• delete_activity : [Requiere inicio de sesión] Eliminar la publicación de actividad del usuario autorizado actual
• get_activity : obtiene una actividad AniList específica por su ID
• get_user_activity : Obtener actividades de un usuario
• post_message_activity : [Requiere inicio de sesión] Publicar una nueva actividad de mensaje o actualizar una existente
• post_text_activity : [Requiere inicio de sesión] Publicar una nueva actividad de texto o actualizar una existente

Herramientas de lista

• get_user_anime_list : Obtener la lista de anime de un usuario
• get_user_manga_list : Obtener la lista de manga de un usuario
• add_list_entry : [Requiere inicio de sesión] Agregar una entrada a la lista de usuarios autorizados
• remove_list_entry : [Requiere inicio de sesión] Eliminar una entrada de la lista del usuario autorizado
• update_list_entry : [Requiere inicio de sesión] Actualizar una entrada en la lista de usuarios autorizados

Herramientas de medios

• get_anime : Obtenga información detallada sobre un anime por su ID de AniList
• get_manga : Obtenga información detallada sobre un manga por su ID de AniList
• favourite_anime : [Requiere iniciar sesión] Marcar o desmarcar un anime como favorito por su ID
• favourite_manga : [Requiere iniciar sesión] Marcar o desmarcar un manga como favorito por su ID

Herramientas para personas

• get_character : Obtener información sobre un personaje por su ID de AniList
• get_staff : obtiene información sobre los miembros del personal por su ID de AniList
• favourite_character : [Requiere inicio de sesión] Marcar o desmarcar un personaje como favorito por su ID
• favourite_staff : [Requiere inicio de sesión] Marcar como favorito o desmarcar como favorito a un miembro del personal por su ID
• get_todays_birthday_characters : Obtener todos los personajes cuyo cumpleaños es hoy
• get_todays_birthday_staff : Obtener todos los miembros del personal cuyo cumpleaños es hoy

Herramientas de recomendación

• get_recommendation : Obtener una recomendación de AniList por su ID
• get_recommendations_for_media : Obtener recomendaciones de AniList para un medio específico

Herramientas de búsqueda

• search_activity : Busca actividades en AniList
• search_anime : Busca anime con términos de consulta y filtros
• search_manga : Busca manga con términos de consulta y filtros
• search_character : busca caracteres según un término de consulta
• search_staff : busca miembros del personal según un término de consulta
• search_studio : Busca estudios según un término de consulta
• search_user : Busca usuarios en AniList

Herramientas de hilo

• get_thread : Obtener un hilo específico por su ID de AniList
• get_thread_comments : Obtener comentarios para un hilo específico
• delete_thread : [Requiere inicio de sesión] Eliminar un hilo por su ID

Herramientas de usuario

• get_user_profile : Obtener el perfil de AniList de un usuario
• get_user_stats : Obtener las estadísticas de AniList de un usuario
• get_full_user_info : Obtener el perfil completo y la información estadística de un usuario
• get_user_recent_activity : Obtener la actividad reciente de un usuario
• get_authorized_user : [Requiere inicio de sesión] Obtener información de perfil del usuario actualmente autorizado
• follow_user : [Requiere inicio de sesión] Seguir o dejar de seguir a un usuario por su ID
• update_user : [Requiere inicio de sesión] Actualizar la configuración del usuario

Ejemplo de uso

Búsqueda básica de anime

Obtener información del personaje

Comparar trabajos de estudio

Desarrollo local

Este proyecto usa Bun como gestor de paquetes. Deberías instalarlo si aún no lo has hecho.

Clonar el repositorio e instalar las dependencias:

Configuración (opcional)

1. Cree un archivo .env copiando el ejemplo:

2. Edite el archivo .env y agregue su token de API AniList:

Depuración con MCP Inspector

Puede utilizar el Inspector MCP para probar y depurar el servidor MCP de AniList:

A continuación, abra su navegador y acceda a la URL proporcionada (normalmente http://127.0.0.1:6274 ) para acceder a la interfaz del Inspector de MCP. Desde allí, podrá:

1. Conéctese a su servidor AniList MCP en ejecución
2. Explorar las herramientas disponibles
3. Ejecutar herramientas con parámetros personalizados
4. Ver las respuestas

Esto es particularmente útil para probar su configuración antes de conectarla a Claude u otro asistente de IA.

Estibador

Extraer de Docker Hub:

Compilación de Docker (desarrollo local):

Compilación multiplataforma de Docker (desarrollo local):

Aviso de seguridad

Este servidor MCP acepta su token de API de AniList en el archivo .env o como variable de entorno. Mantenga esta información segura y nunca la envíe al control de versiones.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.