mcp-animenewsnetwork

An MCP server for Anime News Network. Search the anime and manga encyclopedia, read cast, staff and episode lists, and follow the news wire. No API key, no account, no configuration.

(Version française plus bas / French version below)

Quickstart

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"]
    }
  }
}

Related MCP server: Bangumi TV MCP Service

Tools

Search returns an encyclopedia id and a kind for every result; get_title takes both. That is the intended chain: search, then read.

The server is read-only. It writes nothing back to Anime News Network.

Things worth knowing

Search results carry no records. A name search on the encyclopedia returns the complete record of every match. A search for "One Piece" is 1.4 MB of XML, roughly 360,000 tokens, because 47 full records are embedded in it. This server reduces the same search to about 10 KB of rows. Read the entry you actually want with get_title.

One entry is still large, so sections are opt-in. A record for a long-running series reaches 79 KB: Cowboy Bebop alone carries 101 cast credits, 70 staff credits, 54 releases and 207 linked news items. get_title returns basic by default, and cast, staff, episodes, releases, related, news and reviews only when you ask.

Search matches titles, and nothing else. It cannot find a series from a character, a studio, a genre or a plot detail. There is no full-text search endpoint on the encyclopedia, and the search parameter their reports accept returns nothing. Narrow the query rather than raising limit.

A failure is never an empty result. Anime News Network answers every request with HTTP 200, including its failures, which it reports as a <warning> inside the body. An unknown id would otherwise read as "this series does not exist", so this server turns those warnings into errors with a code.

The news feed is the whole archive. There is no endpoint reaching further back than the feed window, so older coverage cannot be retrieved here.

Configuration

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

The interval floor exists because Anime News Network documents a limit of one request per second per IP and delays anything above it rather than refusing, so pacing faster only queues requests on their side.

How it works

The encyclopedia is a real public XML API, so this server makes plain HTTP calls to https://cdn.animenewsnetwork.com/encyclopedia and maps the responses. The news comes from the RSS feeds on the main site. It sends one request at a time, paces itself, backs off when rate limited, and keeps two in-memory caches: an hour for the encyclopedia, which barely changes, and five minutes for the wire, which publishes several times an hour.

On robots.txt

animenewsnetwork.com/robots.txt disallows /encyclopedia/api.xml, under a comment reading "disallowed for search engines because redundant". This server uses that endpoint anyway, and the reasoning is worth stating so you can judge it yourself.

Anime News Network documents api.xml as a public API, publishes a rate limit for it, asks callers to identify themselves and to attribute the data, and advises caching responses for a week. Those are the instructions of a service that expects clients, not one asking to be left alone. robots.txt governs crawlers building an index; this server issues one request in response to one question from one person, holds the answer briefly, and indexes nothing.

The server honours all of it: one request per second, an identifying User-Agent, caching, and a source link on every result. If Anime News Network would rather it did not exist, opening an issue is enough.

Development

npm install
npm run build:fixtures   # regenerate the XML test fixtures
npm test                 # unit tests, no network
npm run typecheck
npm run build
ANN_LIVE=1 npm run test:live   # hits the real API, excluded from CI
npm run inspector        # explore the tools in the MCP Inspector

Fixtures are generated, not captured: they reproduce Anime News Network's element names and attributes with placeholder titles, so the tests are deterministic and no third-party content lives in this repository.

The API layer (src/ann) does not import the MCP SDK and is published separately as mcp-animenewsnetwork/client, so it can be used as a plain library.

Data and attribution

The encyclopedia and the news wire are the work of Anime News Network and its contributors. This project claims no rights over them and ships none of their content.

Anime News Network asks that anything built on their data names them as the source and links the entry it quotes. Every result this server returns carries a source_url or a link for that purpose. If you display or repeat what it returns, keep that attribution and link back.

This is an unofficial project, with no affiliation to or endorsement by Anime News Network.

License

MIT. See LICENSE. The license covers this source code only, not the data retrieved through it.

mcp-animenewsnetwork (français)

Un serveur MCP pour Anime News Network. Cherchez dans l'encyclopédie anime et manga, lisez les distributions, les équipes et les listes d'épisodes, et suivez le fil d'actualité. Sans clé d'API, sans compte, sans configuration.

Démarrage rapide

Installation en un clic

Claude Code

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

Claude Desktop, Cursor, et tout client utilisant le format standard

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

Outils

La recherche renvoie un id d'encyclopédie et un kind pour chaque résultat, et get_title prend les deux. C'est l'enchaînement prévu : chercher, puis lire.

Le serveur est en lecture seule. Il n'écrit rien vers Anime News Network.

Ce qu'il faut savoir

Les résultats de recherche ne contiennent aucune fiche. Une recherche par nom renvoie la fiche complète de chaque correspondance. « One Piece » représente 1,4 Mo de XML, environ 360 000 tokens, parce que 47 fiches entières y sont imbriquées. Ce serveur ramène la même recherche à environ 10 Ko de lignes. La fiche voulue se lit ensuite avec get_title.

Une fiche reste volumineuse, d'où les sections à la demande. Une série au long cours atteint 79 Ko : Cowboy Bebop porte à elle seule 101 rôles, 70 postes d'équipe, 54 éditions et 207 actualités liées. get_title renvoie basic par défaut, et cast, staff, episodes, releases, related, news et reviews seulement sur demande.

La recherche porte sur les titres, et rien d'autre. Elle ne sait pas retrouver une série depuis un personnage, un studio, un genre ou un élément d'intrigue. L'encyclopédie n'expose aucune recherche plein texte, et le paramètre search que leurs rapports acceptent ne renvoie rien. Affinez la requête plutôt que d'augmenter limit.

Un échec n'est jamais un résultat vide. Anime News Network répond à toutes les requêtes en HTTP 200, y compris à ses échecs, signalés par un <warning> dans le corps. Un id inconnu se lirait sinon comme « cette série n'existe pas », donc ce serveur transforme ces avertissements en erreurs avec un code.

Le fil d'actualité est toute l'archive disponible. Aucun endpoint ne remonte au-delà de la fenêtre du flux, les couvertures plus anciennes sont donc hors de portée ici.

Configuration

Toutes les variables sont optionnelles, à déclarer dans le bloc env de votre client.

Le plancher sur l'intervalle existe parce qu'Anime News Network documente une limite d'une requête par seconde par IP et retarde ce qui la dépasse au lieu de refuser : aller plus vite ne fait que constituer une file d'attente chez eux.

Fonctionnement

L'encyclopédie est une véritable API XML publique. Ce serveur fait donc de simples appels HTTP vers https://cdn.animenewsnetwork.com/encyclopedia et transpose les réponses. Les actualités viennent des flux RSS du site principal. Il envoie une requête à la fois, s'impose un rythme, ralentit en cas de limitation, et garde deux caches mémoire : une heure pour l'encyclopédie, qui bouge à peine, et cinq minutes pour le fil, qui publie plusieurs fois par heure.

À propos du robots.txt

Le robots.txt d'animenewsnetwork.com interdit /encyclopedia/api.xml, sous un commentaire indiquant « disallowed for search engines because redundant ». Ce serveur utilise malgré tout cet endpoint, et le raisonnement mérite d'être exposé pour que vous puissiez en juger.

Anime News Network documente api.xml comme une API publique, en publie la limite de débit, demande aux clients de s'identifier et d'attribuer les données, et conseille de mettre les réponses en cache une semaine. Ce sont les instructions d'un service qui attend des clients, pas d'un service qui demande qu'on le laisse tranquille. Le robots.txt encadre les robots d'indexation ; ce serveur émet une requête en réponse à une question d'une personne, garde brièvement la réponse, et n'indexe rien.

Le serveur respecte l'ensemble : une requête par seconde, un User-Agent identifiant, la mise en cache, et un lien source sur chaque résultat. Si Anime News Network préfère qu'il n'existe pas, ouvrir une issue suffit.

Développement

npm install
npm run build:fixtures   # régénère les fixtures XML de test
npm test                 # tests unitaires, sans réseau
npm run typecheck
npm run build
ANN_LIVE=1 npm run test:live   # touche la vraie API, exclu de la CI
npm run inspector        # explorer les outils dans le MCP Inspector

Les fixtures sont générées, pas capturées : elles reproduisent les noms d'éléments et d'attributs d'Anime News Network avec des titres de remplissage, ce qui rend les tests déterministes et évite de stocker du contenu tiers dans ce dépôt.

La couche API (src/ann) n'importe pas le SDK MCP et est publiée séparément sous mcp-animenewsnetwork/client, utilisable comme simple bibliothèque.

Données et attribution

L'encyclopédie et le fil d'actualité sont l'œuvre d'Anime News Network et de ses contributeurs. Ce projet ne revendique aucun droit dessus et n'embarque aucun de leurs contenus.

Anime News Network demande que tout ce qui s'appuie sur leurs données les cite comme source et renvoie vers la fiche concernée. Chaque résultat de ce serveur porte un source_url ou un link à cet effet. Si vous affichez ou reprenez ce qu'il renvoie, conservez cette attribution et le lien.

Projet non officiel, sans affiliation à Anime News Network ni approbation de sa part.

Licence

MIT, voir LICENSE. La licence couvre uniquement le code source, pas les données récupérées par son intermédiaire.