Servidor MCP de AniList

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

Características

• Búsqueda de anime, manga, personajes, personal y estudios
• Obtén información detallada sobre anime, manga, personajes y empleados específicos
• Acceso a perfiles y listas de usuarios
• Soporte para opciones avanzadas de filtrado
• Recuperar géneros y etiquetas multimedia

Requisitos previos

• Node.js 18+

Uso con Claude Desktop (u otros clientes MCP)

Instalación a través de Smithery

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

npx -y @smithery/cli install @yuna0x0/anilist-mcp --client claude # Para otros clientes MCP, utiliza el siguiente comando: # Listar los clientes disponibles npx -y @smithery/cli list clients # Instalar en otros clientes npx -y @smithery/cli install @yuna0x0/anilist-mcp --client <nombre_cliente>

Instalación mediante mcp-get

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

Instalación manual

1. Añade este servidor a tu claude_desktop_config.json:

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

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

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

Variables de entorno

• ANILIST_TOKEN: (Opcional) Token API AniList (Sólo necesario para operaciones que requieran inicio de sesión)

Obtener un token de la API de AniList (Opcional)

Para obtener un token de API, sigue estos pasos:

1. Ve a la configuración de AniList.
2. Haz clic en "Crear nuevo cliente".
3. Utiliza esta URL como "URL de redireccionamiento" de tu cliente:

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

4. Haz clic en "Guardar"
5. A continuación, ve a https://anilist.co/api/v2/oauth/authorize?client_id={clientID}&response_type=token, sustituye {clientID} por el ID de cliente que obtengas. Te pedirá que inicies sesión y te proporcionará el token que debes utilizar.
6. Copia el token generado y utilízalo en tu archivo .env o en tus variables de entorno.

Herramientas disponibles

Herramientas varias

• get_genres: Obtiene todos los géneros disponibles en AniList
• get_media_tags: Obtener todas las etiquetas multimedia disponibles en AniList
• get_site_statistics: Obtiene las estadísticas del sitio AniList de los últimos siete días
• get_studio: Obtener información sobre un estudio por su ID de AniList o su nombre
• favourite_studio: [Favoritar o Desfavorecer un estudio por su ID

Herramientas de actividad

• delete_activity: [Requiere inicio de sesión] Elimina el mensaje de actividad del usuario autorizado actual
• get_activity: Obtener una actividad específica de AniList 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] Publica una nueva actividad de texto o actualiza 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 mangas de un usuario
• add_list_entry: [Requiere Login] Añadir una entrada a la lista de usuarios autorizados
• remove_list_entry: [Eliminar una entrada de la lista de usuarios autorizados
• update_list_entry: [Actualizar una entrada de la lista de usuarios autorizados

Herramientas multimedia

• get_anime: Obtén información detallada sobre un anime por su ID de AniList
• get_manga: Obtener información detallada sobre un manga por su ID de AniList
• favourite_anime: [Favorita o no favorita una película por su ID
• favourite_manga: [Requiere inicio de sesión] Marcar como favorito o no un manga por su ID

Herramientas

• get_character: Obtén información sobre un personaje por su ID de AniList
• get_staff: Obtener información sobre un miembro del personal por su ID de AniList
• favourite_character: [Requiere inicio de sesión] Favorecer o desfavorecer un personaje por su ID
• favourite_staff: [Favorecer o no favorecer 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 empleados que cumplen años 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

• buscar_actividad: Buscar actividades en AniList
• search_anime: Buscar anime con término de consulta y filtros
• search_manga: Buscar manga con término de consulta y filtros
• search_character: Búsqueda de personajes basada en un término de consulta
• search_staff: Buscar miembros del personal basándose en un término de consulta
• search_studio: Búsqueda de estudios basada en un término de consulta
• search_user: Buscar usuarios en AniList

Herramientas

• get_thread: Obtener un hilo específico por su ID de AniList
• get_thread_comments: Obtener los comentarios de un tema específico
• delete_thread: [Requiere Login] Borrar un tema por su ID

Herramientas de usuario

• get_user_profile: Obtener el perfil AniList de un usuario
• get_user_stats: Obtener las estadísticas de AniList de un usuario
• get_full_user_info: Obtiene la información completa del perfil y las estadísticas de un usuario
• get_user_recent_activity: Obtiene la actividad reciente de un usuario
• get_authorized_user: [Requiere Login] Obtiene información del perfil del usuario actualmente autorizado
• follow_user: [Requiere inicio de sesión] Sigue o deja de seguir a un usuario por su ID
• update_user: [Requiere inicio de sesión] Actualiza la configuración del usuario

Ejemplo de uso

Búsqueda básica de anime

¿Puedes buscar un anime similar a "Bocchi the Rock!"?

Obtener información del personaje

¿Puedes informarme sobre el personaje Hitori Gotou? Utiliza las herramientas de AniList para encontrar información

Comparar obras del estudio

¿Qué anime ha producido Studio Ghibli? ¿Puedes enumerar sus obras más populares?

Desarrollo local

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

Clona el repositorio e instala las dependencias:

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

Configuración (opcional)

1. Crea un archivo .env copiando el ejemplo:

cp .env.ejemplo .env

2. Edita el archivo .env y añade tu token de la API de AniList:

ANILIST_TOKEN=tu_api_token

Depuración con el Inspector MCP

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

npx @modelcontextprotocol/inspector -e ANILIST_TOKEN=su_api_token npx anilist-mcp # Utiliza esto en su lugar cuando Local Development bun ejecute inspector

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

1. Conectarte a tu servidor MCP AniList en ejecución
2. Examinar las herramientas disponibles
3. Ejecutar herramientas con parámetros personalizados
4. Ver las respuestas

Esto es especialmente útil para probar tu configuración antes de conectarla a Claude o a otro asistente de IA.

Docker

Tire de Docker Hub:

docker pull yuna0x0/anilist-mcp

Docker build (Desarrollo local):

docker build -t yuna0x0/anilist-mcp

Docker multi-platform build (Desarrollo local):

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

Aviso de seguridad

Este servidor MCP acepta tu token de la 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 - vea el archivo LICENSE para más detalles.