mcp animenewsnetwork

mcp-animenewsnetwork

Anime News Network has been covering anime and manga since 1998. It keeps an encyclopedia of the works themselves, with the cast and staff credited on each, the episodes, the releases, the opening and ending themes and the readers' ratings, and it runs a news wire alongside it, with separate editions for the United States, the United Kingdom and Australia.

This server connects a chat client to both. You can search the encyclopedia for an anime or a manga, read one entry with its credits and its details, list what was recently added or browse the encyclopedia alphabetically, and read the news wire. It needs no API key and no account.

Version française

---

Install

One-click install

Claude Code

claude mcp add animenewsnetwork -- npx -y mcp-animenewsnetwork

Claude Desktop, Cursor, and any client using the standard config format

{
  "mcpServers": {
    "animenewsnetwork": {
      "command": "npx",
      "args": ["-y", "mcp-animenewsnetwork"]
    }
  }
}

Node 24 or later is required, and no environment variable has to be set.

With Docker

{
  "mcpServers": {
    "animenewsnetwork": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-animenewsnetwork:2.0.1"]
    }
  }
}

-i keeps stdin open, which is where the protocol travels, and -t is left out because a TTY rewrites the stream. The container needs outbound HTTPS to cdn.animenewsnetwork.com and www.animenewsnetwork.com, and nothing else: no volume, no port, no credential.

Bundle, without npm

Download mcp-animenewsnetwork-2.0.1.mcpb from the latest release and open it. A client that supports MCP bundles installs it on its own, with no npm and no configuration file to edit. The bundle carries its dependencies, so nothing is fetched at install time.

What you can ask

• "What does the encyclopedia have on Cowboy Bebop?"
• "Who voiced Spike, and in which languages?"
• "What anime were added to the encyclopedia recently?"
• "What is the anime news today?"
• "How did readers rate that series?"

The ordinary path runs from a search to an entry: a row carries an id and a kind, and get_title takes both together.

Tools

Tool	What it does
search_titles	Finds anime and manga by title in the encyclopedia.
get_title	Reads one entry, its credits and its details.
list_recent	Lists what was recently added, or browses the encyclopedia by letter.
get_news	Reads the news wire.

An entry is addressed by its id together with its kind, since the encyclopedia numbers anime and manga separately.

search_titles

Finds anime and manga by title.

Argument	Type	Required	What it does
query	string, at least 1 character	yes	A title, or part of one.
kind	anime, manga or both, default both	no	Which part of the encyclopedia.
limit	integer, 1 to 50, default 10	no	Rows to serve.

In return: rows carrying id and kind, which get_title takes together; name; type, reading TV, movie, OAV, ONA, special, manga or novel; precision; vintage, the original release date or range as published; and source_url. A field the entry leaves empty is null.

get_title

Reads one entry. The heavier parts are asked for rather than served by default.

Argument	Type	Required	What it does
id	integer, 1 or more	yes	The encyclopedia id.
kind	anime or manga	yes	Which lookup the id belongs to.
sections	array of basic, cast, staff, episodes, releases, related, news, reviews, default ["basic"]	no	Which parts to return.
max_chars	integer, 200 to 20000, default 4000	no	How much of the plot summary to serve.
offset	integer, 0 or more, default 0	no	Where to resume the plot summary.

In return: the entry a search row carries, plus alt_titles, genres, themes, episode_count, running_time, objectionable_content, official_websites, picture_url, opening_themes and ending_themes. ratings carries the readers' votes, weighted_score and bayesian_score, each null where the encyclopedia computed none. plot_summary is served a slice at a time, described by total_chars, returned_chars, offset, next_offset and truncated. A cast entry names the role, the person and the lang they performed in.

list_recent

Lists what was recently added to the encyclopedia, or browses it by first letter.

Argument	Type	Required	What it does
kind	anime, manga, person or company, default anime	no	What to list.
starts_with	a single character	no	Browse the entries beginning with it.
limit	integer, 1 to 50, default 20	no	Rows to serve.
offset	integer, 0 or more, default 0	no	Rows to skip, for paging.

In return: rows, each carrying id, kind, name, type, precision, vintage, date_added and source_url, any of which the report may leave empty. mode says whether the answer was read as recent or as browse, since passing starts_with changes the question being asked, and next_offset continues.

get_news

Reads the news wire.

Argument	Type	Required	What it does
feed	all, news or reviews, default all	no	Which feed to read.
edition	us, uk or au, default us	no	Which edition.
category	string	no	Keep the stories of one category.
limit	integer, 1 to 100, default 20	no	Stories to serve.

In return: items, each with its title, link, summary, category and published_at as an ISO timestamp when the feed's date could be read. total_available counts the stories the feed held, which is a fixed feed length rather than the size of the archive.

Configuration

Every variable is optional. Set them in the env block of your client config.

Variable	Default	What it does
ANN_USER_AGENT	the project identity	Names your application to the service, with an address where a person can be reached.
ANN_MIN_INTERVAL_MS	1100	Gap between two requests, from 1000 to 60000.
ANN_TIMEOUT_MS	15000	Deadline for one request, from 1000 to 120000.
ANN_MAX_RETRIES	3	Attempts after a transient failure, from 0 to 10.
ANN_CACHE_TTL_MS	3600000	How long an encyclopedia entry stays in memory, from 0 to 86400000.
ANN_NEWS_CACHE_TTL_MS	300000	How long a news feed stays in memory, from 0 to 86400000.
ANN_CACHE_MAX_ENTRIES	200	Answers held in memory at once, from 0 to 10000.
ANN_LOG_LEVEL	error	silent, error, info or debug, written to stderr.

The news wire publishes several times an hour where the encyclopedia changes rarely, so the two are held for different lengths of time. A value outside its range falls back to the default, and the reason is written to stderr.

Errors

Every failure carries one of six codes, a message, and where it helps a hint naming the next move.

Code	What happened	What to do
not_found	The service answered, and holds no such entry.	Check the id and the kind with search_titles.
invalid_input	The arguments were refused before any request went out.	Read the message, which names the argument.
rate_limited	The service asked this client to slow down.	Wait the number of seconds the hint names and call again with the same arguments. The entry is still there.
parse_failure	The answer arrived in a shape this client cannot read.	Report it at the issue tracker.
network_error	The request did not complete.	Try again shortly.
timeout	The request passed its deadline.	Raise ANN_TIMEOUT_MS, or ask for fewer rows.

As a library

The layer reading the service is published on its own, with its pacing, its cache and its errors, and with no protocol attached.

import { AnnClient } from "mcp-animenewsnetwork/client";

const client = new AnnClient();
const { data, cached } = await client.getTitle({ id: 1, kind: "anime" });
console.log(data.name, cached);

Each read answers { data, cached }, and throws an error carrying one of the six codes. The floor between two requests holds here as well.

Pacing and attribution

Requests go out one at a time with at least 1.1 seconds between them, and the floor of one second holds however the server is configured. The User-Agent always ends with the project identity and an address where a person can be reached.

Every result carries the address of the encyclopedia page or of the article. The encyclopedia and the news are the work of Anime News Network and its contributors, and attribution is what the service asks for in return.

This MCP server is an unofficial project, with no affiliation to Anime News Network.

Privacy

This server collects nothing about you and sends nothing to its author. It runs on your machine, contacts cdn.animenewsnetwork.com and www.animenewsnetwork.com and nothing else, holds its answers in memory while it runs, and writes nothing to disk. PRIVACY.md states what a request carries and which settings change any of it.

Development

npm install
npm run build:fixtures
npm test
npm run check

Tests run against generated fixtures and make no network request. The live suite, npm run test:live, makes one request per route and runs nightly against the service itself.

Contributing

Bugs, questions and ideas belong in the issue tracker. Pull requests are welcome; opening an issue first helps agree on the shape of the change. See CONTRIBUTING.md.

License

MIT, see LICENSE. The encyclopedia and the news belong to Anime News Network and its contributors.

---

mcp-animenewsnetwork (français)

English version

Anime News Network couvre l'anime et le manga depuis 1998. Le site tient une encyclopédie des œuvres elles-mêmes, avec les interprètes et l'équipe créditée sur chacune, les épisodes, les parutions, les génériques de début et de fin et les notes de ses lecteurs, et il fait tourner à côté un fil d'actualité, avec des éditions distinctes pour les États-Unis, le Royaume-Uni et l'Australie.

Ce serveur relie un client de conversation aux deux. On peut chercher un anime ou un manga dans l'encyclopédie, lire une fiche avec ses crédits et ses détails, lister ce qui vient d'être ajouté ou parcourir l'encyclopédie par lettre, et lire le fil d'actualité. Aucune clé d'API, aucun compte.

Installation

Installation en un clic

Claude Code

claude mcp add animenewsnetwork -- npx -y mcp-animenewsnetwork

Claude Desktop, Cursor, et tout client au format de configuration standard

{
  "mcpServers": {
    "animenewsnetwork": {
      "command": "npx",
      "args": ["-y", "mcp-animenewsnetwork"]
    }
  }
}

Node 24 ou plus récent est nécessaire, et aucune variable d'environnement n'est à renseigner.

Avec Docker

{
  "mcpServers": {
    "animenewsnetwork": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-animenewsnetwork:2.0.1"]
    }
  }
}

-i garde l'entrée standard ouverte, qui est le canal du protocole, et -t est omis parce qu'un TTY réécrit le flux. Le conteneur a besoin d'un accès HTTPS sortant vers cdn.animenewsnetwork.com et www.animenewsnetwork.com, et de rien d'autre : aucun volume, aucun port, aucun identifiant.

Bundle, sans npm

Téléchargez mcp-animenewsnetwork-2.0.1.mcpb depuis la dernière publication et ouvrez-le. Un client qui gère les bundles MCP l'installe seul, sans npm et sans fichier de configuration à modifier. Le bundle emporte ses dépendances, donc rien n'est téléchargé à l'installation.

Ce qu'on peut demander

• « Qu'est-ce que l'encyclopédie a sur Cowboy Bebop ? »
• « Qui a doublé Spike, et dans quelles langues ? »
• « Quels animes ont été ajoutés récemment à l'encyclopédie ? »
• « Quelle est l'actualité anime du jour ? »
• « Comment les lecteurs ont-ils noté cette série ? »

Le chemin ordinaire va d'une recherche à une fiche : une ligne porte un id et un kind, et get_title reprend les deux ensemble.

Les outils

Outil	Ce qu'il fait
search_titles	Trouve des animes et des mangas par leur titre dans l'encyclopédie.
get_title	Lit une fiche, ses crédits et ses détails.
list_recent	Liste les ajouts récents, ou parcourt l'encyclopédie par lettre.
get_news	Lit le fil d'actualité.

Une fiche s'adresse par son id accompagné de son kind, l'encyclopédie numérotant les animes et les mangas séparément.

search_titles

Trouve des animes et des mangas par leur titre.

Argument	Type	Requis	Ce qu'il fait
query	chaîne, au moins 1 caractère	oui	Un titre, ou une partie.
kind	anime, manga ou both, défaut both	non	La partie de l'encyclopédie.
limit	entier, 1 à 50, défaut 10	non	Lignes à servir.

En retour : des lignes portant id et kind, que get_title reprend ensemble ; name ; type, valant TV, movie, OAV, ONA, special, manga ou novel ; precision ; vintage, la date ou la période de parution telle que publiée ; et source_url. Un champ que la fiche laisse vide vaut null.

get_title

Lit une fiche. Les parties lourdes se demandent au lieu d'être servies par défaut.

Argument	Type	Requis	Ce qu'il fait
id	entier, 1 ou plus	oui	L'identifiant encyclopédique.
kind	anime ou manga	oui	Le registre dont l'id relève.
sections	tableau de basic, cast, staff, episodes, releases, related, news, reviews, défaut ["basic"]	non	Les parties à rendre.
max_chars	entier, 200 à 20000, défaut 4000	non	La longueur de résumé à servir.
offset	entier, 0 ou plus, défaut 0	non	Où reprendre le résumé.

En retour : la fiche que porte une ligne de recherche, plus alt_titles, genres, themes, episode_count, running_time, objectionable_content, official_websites, picture_url, opening_themes et ending_themes. ratings porte les votes des lecteurs, le weighted_score et le bayesian_score, chacun null là où l'encyclopédie n'en a calculé aucun. plot_summary est servi par tranches, décrites par total_chars, returned_chars, offset, next_offset et truncated. Une entrée de distribution nomme le role, la person et la langue lang dans laquelle elle a joué.

list_recent

Liste les ajouts récents à l'encyclopédie, ou la parcourt par première lettre.

Argument	Type	Requis	Ce qu'il fait
kind	anime, manga, person ou company, défaut anime	non	Ce qu'il faut lister.
starts_with	un seul caractère	non	Parcourt les fiches commençant par lui.
limit	entier, 1 à 50, défaut 20	non	Lignes à servir.
offset	entier, 0 ou plus, défaut 0	non	Lignes à sauter, pour paginer.

En retour : rows, chacune portant id, kind, name, type, precision, vintage, date_added et source_url, que le rapport peut laisser vides. mode dit si la réponse a été lue en recent ou en browse, passer starts_with changeant la question posée, et next_offset poursuit.

get_news

Lit le fil d'actualité.

Argument	Type	Requis	Ce qu'il fait
feed	all, news ou reviews, défaut all	non	Le fil à lire.
edition	us, uk ou au, défaut us	non	L'édition.
category	chaîne	non	Ne garder que les sujets d'une catégorie.
limit	entier, 1 à 100, défaut 20	non	Sujets à servir.

En retour : items, chacun avec son title, link, summary, category et published_at en horodatage ISO quand la date du fil a pu être lue. total_available compte les sujets que le fil contenait, ce qui est une longueur de fil fixe et non la taille des archives.

Configuration

Chaque variable est facultative. Elles se posent dans le bloc env de la configuration du client.

Variable	Défaut	Ce qu'elle fait
ANN_USER_AGENT	l'identité du projet	Nomme votre application auprès du service, avec une adresse où joindre une personne.
ANN_MIN_INTERVAL_MS	1100	Écart entre deux requêtes, de 1000 à 60000.
ANN_TIMEOUT_MS	15000	Délai d'une requête, de 1000 à 120000.
ANN_MAX_RETRIES	3	Tentatives après un échec passager, de 0 à 10.
ANN_CACHE_TTL_MS	3600000	Durée pendant laquelle une fiche reste en mémoire, de 0 à 86400000.
ANN_NEWS_CACHE_TTL_MS	300000	Durée pendant laquelle un fil reste en mémoire, de 0 à 86400000.
ANN_CACHE_MAX_ENTRIES	200	Réponses gardées en mémoire à la fois, de 0 à 10000.
ANN_LOG_LEVEL	error	silent, error, info ou debug, écrit sur la sortie d'erreur.

Le fil d'actualité publie plusieurs fois par heure là où l'encyclopédie change rarement, donc les deux sont gardés des durées différentes. Une valeur hors de sa plage retombe sur le défaut, et la raison est écrite sur la sortie d'erreur.

Erreurs

Chaque échec porte un des six codes, un message, et quand cela aide une indication du geste suivant.

Code	Ce qui s'est passé	Que faire
not_found	Le service a répondu, et n'a pas cette fiche.	Vérifiez l'identifiant et le type avec search_titles.
invalid_input	Les arguments ont été refusés avant toute requête.	Lisez le message, qui nomme l'argument.
rate_limited	Le service demande à ce client de ralentir.	Attendez les secondes indiquées et rappelez avec les mêmes arguments. La fiche est toujours là.
parse_failure	La réponse est arrivée dans une forme illisible ici.	Signalez-le sur le suivi d'incidents.
network_error	La requête n'a pas abouti.	Réessayez sous peu.
timeout	La requête a dépassé son délai.	Augmentez ANN_TIMEOUT_MS, ou demandez moins de lignes.

Comme bibliothèque

La couche qui lit le service est publiée seule, avec son rythme, son cache et ses erreurs, sans protocole attaché.

import { AnnClient } from "mcp-animenewsnetwork/client";

const client = new AnnClient();
const { data, cached } = await client.getTitle({ id: 1, kind: "anime" });
console.log(data.name, cached);

Chaque lecture répond { data, cached }, et lève une erreur portant un des six codes. Le plancher entre deux requêtes tient également ici.

Rythme et attribution

Les requêtes partent une à une avec au moins 1,1 seconde entre elles, et le plancher d'une seconde tient quelle que soit la configuration. Le User-Agent se termine toujours par l'identité du projet et une adresse où joindre une personne.

Chaque résultat porte l'adresse de la page encyclopédique ou de l'article. L'encyclopédie et l'actualité sont l'œuvre d'Anime News Network et de ses contributeurs, et l'attribution est ce que le service demande en retour.

Ce MCP est un projet non officiel, sans affiliation à Anime News Network.

Confidentialité

Ce serveur ne collecte rien sur vous et n'envoie rien à son auteur. Il tourne sur votre machine, ne joint que cdn.animenewsnetwork.com et www.animenewsnetwork.com, garde ses réponses en mémoire le temps qu'il tourne, et n'écrit rien sur le disque. PRIVACY.md dit ce qu'une requête emporte et quels réglages changent cela.

Développement

npm install
npm run build:fixtures
npm test
npm run check

Les tests s'exécutent sur des fixtures engendrées et n'émettent aucune requête. La suite en direct, npm run test:live, émet une requête par route et tourne chaque nuit contre le service lui-même.

Contribuer

Les anomalies, les questions et les idées ont leur place dans le suivi d'incidents. Les propositions de modification sont bienvenues ; ouvrir un ticket d'abord aide à s'accorder sur la forme du changement. Voir CONTRIBUTING.md.

Licence

MIT, voir LICENSE. L'encyclopédie et l'actualité appartiennent à Anime News Network et à ses contributeurs.