mcp-databnf
[npm]
[CI]
[license]
[MCP Registry]
[Glama]
[M8ven]
[LobeHub]
[Install in Cursor]
[Install in VS Code]
data.bnf.fr is the open data service of the Bibliothèque
nationale de France. It publishes the authority records the national library
maintains: the people it catalogues, with their dates, their places, their
languages and their fields of activity; the works they wrote, with the editions
each work was published in; and the links to the copies digitised in Gallica. A
record states whether the library considers it established or still provisional.
This server connects a chat client to that service. You can search for an author
or a work by name, read a record in full, list what an author wrote, list the
editions of a work, and find the digitised copies attached to either. It needs no
API key and no account.
Version française
Install
One-click install
[Install in Cursor]
[Install in VS Code]
Claude Code
Claude Desktop, Cursor, and any client using the standard config format
Node 24 or later is required, and no environment variable has to be set.
With Docker
-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
data.bnf.fr, and nothing else: no volume, no port, no credential.
Bundle, without npm
Download mcp-databnf-2.2.0.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
- « Que dit la BnF de Colette ? »
- "List everything Marguerite Duras wrote."
- "Which editions of that work does the library hold?"
- "Are any of them digitised in Gallica?"
- "When was that record last established?"
The ordinary path runs from a search to a record: a row carries an id, and
get_author or get_work reads it.
Tools
search_authors
Finds people by name in the authority records.
In return: authors, each carrying id, which get_author, list_works
and find_digitised take; name as the service writes it; label, the
authority heading, usually with the dates; birth_year and death_year, null
where the record states none; role; and source_url. words_searched says
what was actually sent, has_more whether further pages exist, and
index_window_full that the index served everything it will serve for this
search.
get_author
Reads one person's record in full.
In return: the person with name, label, given_name, family_name,
other_names, birth_date and death_date as published, birth_year and
death_year as numbers, birth_place, death_place,
biographical_information, occupation, languages as ISO 639-2 codes,
countries and fields in the words of the record. A field the record leaves
empty is null.
search_works
Finds works by title.
In return: works, each carrying id, which get_work, list_editions and
find_digitised take; title; date, the year the record gives the work, as
published; creators; status, reading established or provisional; and
source_url. The envelope carries the same words_searched, has_more and
index_window_full a search of people returns.
get_work
Reads one work's record in full.
In return: the work with title, label, date as published, first_year,
creators as { id, name }, languages, forms, subjects and
dewey_classes in the words of the record, expression_count, same_as for the
registers the BnF aligns it with, and catalogue_url. status reads
established or provisional, and status_statement says what the library
means by it: a provisional record is one the library has not finished checking.
list_works
Lists the works one person is credited with.
In return: works, each carrying id, title, date as published, year
as a number where the record has one, forms, status and source_url, with
has_more to continue.
list_editions
Lists the editions of one work.
In return: editions, each carrying its own id in the BnF catalogue, the
title this edition bears, date and year, publisher, place,
edition_statement, extent, isbn, note as the cataloguer wrote it,
catalogue_url, digitised and source_url. A field the record leaves empty is
null.
find_digitised
Finds the copies digitised in Gallica attached to a person or a work.
In return: kind, saying what the catalogue types the record as, and links,
each carrying the Gallica ark, its url, its rendering and the role the
person holds on it. links_returned_by_role counts them per role. This server
describes a digitised document and never opens one.
Established and provisional records
A record carries a status. established means the library has checked it;
provisional means it has not finished, and status_statement says so in the
library's own words. Report the status alongside anything taken from a
provisional record.
The licence, and what it asks
The BnF states one condition on these metadata:
L'utilisation de ces métadonnées est libre et gratuite sous réserve du maintien
de la mention de leur source et de l'indication de leur date de récupération.
Use is free of charge, provided the source is named and the date of retrieval is
stated. Every answer carries retrieved_at in its payload and ends its text with
the source and that date. A cached answer reports the moment it was originally
read, since that is when it was retrieved. Repeat both wherever what you got is
shown.
Configuration
Every variable is optional. Set them in the env block of your client config.
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.
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.
getAuthor and getWork each answer { data, cached }, and throw an error
carrying one of the six codes. The three-second floor between two requests holds
here as well.
Pacing and attribution
Requests go out one at a time with at least three seconds between them, and that
floor holds however the server is configured. Each question is answered by a
SPARQL query against a public endpoint the BnF runs at its own expense, which is
why the interval is wide and the deadline long. The User-Agent always ends with
the project identity and an address where a person can be reached.
Every answer carries the source and retrieved_at, which the licence asks to be
stated wherever the metadata are shown.
This MCP server is an unofficial project, with no affiliation to the
Bibliothèque nationale de France.
Privacy
This server collects nothing about you and sends nothing to its author. It runs
on your machine, contacts data.bnf.fr 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
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 metadata belong to the Bibliothèque nationale de
France, free to use provided the source and the date of retrieval are stated.
mcp-databnf (français)
English version
data.bnf.fr est le service de données ouvertes de la
Bibliothèque nationale de France. Il publie les notices d'autorité que la
bibliothèque nationale entretient : les personnes qu'elle catalogue, avec leurs
dates, leurs lieux, leurs langues et leurs domaines d'activité ; les œuvres
qu'elles ont écrites, avec les éditions dans lesquelles chaque œuvre a paru ; et
les liens vers les exemplaires numérisés dans Gallica. Une notice indique si la
bibliothèque la tient pour établie ou encore provisoire.
Ce serveur relie un client de conversation à ce service. On peut y chercher un
auteur ou une œuvre par son nom, lire une notice en entier, lister ce qu'un
auteur a écrit, lister les éditions d'une œuvre, et trouver les exemplaires
numérisés attachés à l'un ou l'autre. Aucune clé d'API, aucun compte.
Installation
Installation en un clic
[Install in Cursor]
[Install in VS Code]
Claude Code
Claude Desktop, Cursor, et tout client au format de configuration standard
Node 24 ou plus récent est nécessaire, et aucune variable d'environnement n'est à
renseigner.
Avec Docker
-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 data.bnf.fr, et de rien d'autre : aucun volume, aucun port, aucun
identifiant.
Bundle, sans npm
Téléchargez mcp-databnf-2.2.0.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
- « Que dit la BnF de Colette ? »
- « Liste tout ce qu'a écrit Marguerite Duras. »
- « Quelles éditions de cette œuvre la bibliothèque conserve-t-elle ? »
- « Y en a-t-il de numérisées dans Gallica ? »
- « Cette notice est-elle établie ou provisoire ? »
Le chemin ordinaire va d'une recherche à une notice : une ligne porte un id, et
get_author ou get_work la lit.
Les outils
search_authors
Trouve des personnes par leur nom dans les notices d'autorité.
En retour : authors, chacun portant id, que get_author, list_works et
find_digitised reprennent ; name tel que le service l'écrit ; label, la
vedette d'autorité, généralement avec les dates ; birth_year et death_year,
null là où la notice n'en indique pas ; role ; et source_url.
words_searched dit ce qui a réellement été envoyé, has_more s'il existe
d'autres pages, et index_window_full que l'index a servi tout ce qu'il servira
pour cette recherche.
get_author
Lit la notice d'une personne en entier.
En retour : la personne avec name, label, given_name, family_name,
other_names, birth_date et death_date tels que publiés, birth_year et
death_year en nombres, birth_place, death_place,
biographical_information, occupation, languages en codes ISO 639-2,
countries et fields dans les mots de la notice. Un champ que la notice laisse
vide vaut null.
search_works
Trouve des œuvres par leur titre.
En retour : works, chacune portant id, que get_work, list_editions et
find_digitised reprennent ; title ; date, l'année que la notice donne à
l'œuvre, telle que publiée ; creators ; status, valant established ou
provisional ; et source_url. L'enveloppe porte les mêmes words_searched,
has_more et index_window_full qu'une recherche de personnes.
get_work
Lit la notice d'une œuvre en entier.
En retour : l'œuvre avec title, label, date telle que publiée,
first_year, creators en { id, name }, languages, forms, subjects et
dewey_classes dans les mots de la notice, expression_count, same_as pour
les registres auxquels la BnF l'aligne, et catalogue_url. status vaut
established ou provisional, et status_statement dit ce que la bibliothèque
entend par là : une notice provisoire est une notice qu'elle n'a pas fini de
vérifier.
list_works
Liste les œuvres attribuées à une personne.
En retour : works, chacune portant id, title, date telle que publiée,
year en nombre quand la notice en a un, forms, status et source_url, avec
has_more pour poursuivre.
list_editions
Liste les éditions d'une œuvre.
En retour : editions, chacune portant son propre id au catalogue de la
BnF, le title que cette édition porte, date et year, publisher, place,
edition_statement, extent, isbn, note telle que le catalogueur l'a
écrite, catalogue_url, digitised et source_url. Un champ que la notice
laisse vide vaut null.
find_digitised
Trouve les exemplaires numérisés dans Gallica attachés à une personne ou à une
œuvre.
En retour : kind, qui dit de quel type le catalogue tient la notice, et
links, chacun portant l'ark Gallica, son url, son rendering et le role
que la personne y tient. links_returned_by_role les compte par rôle. Ce serveur
décrit un document numérisé et n'en ouvre jamais aucun.
Notices établies et provisoires
Une notice porte un status. established signifie que la bibliothèque l'a
vérifiée ; provisional qu'elle ne l'a pas terminée, et status_statement le
dit dans ses propres mots. Rapportez ce statut à côté de tout ce qui vient d'une
notice provisoire.
La licence, et ce qu'elle demande
La BnF pose une condition sur ces métadonnées :
L'utilisation de ces métadonnées est libre et gratuite sous réserve du maintien
de la mention de leur source et de l'indication de leur date de récupération.
Chaque réponse porte retrieved_at dans sa charge utile et termine son texte par
la source et cette date. Une réponse servie depuis le cache rapporte le moment où
elle a été lue à l'origine, puisque c'est sa date de récupération. Redonnez les
deux partout où ce que vous avez obtenu est montré.
Configuration
Chaque variable est facultative. Elles se posent dans le bloc env de la
configuration du client.
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.
Comme bibliothèque
La couche qui lit le service est publiée seule, avec son rythme, son cache et ses
erreurs, sans protocole attaché.
getAuthor et getWork répondent chacun { data, cached }, et lèvent une
erreur portant un des six codes. Le plancher de trois secondes entre deux
requêtes tient également ici.
Rythme et attribution
Les requêtes partent une à une avec au moins trois secondes entre elles, et ce
plancher tient quelle que soit la configuration. Chaque question se résout par
une requête SPARQL contre un point d'accès public que la BnF fait tourner à ses
frais, d'où un intervalle large et un délai long. Le User-Agent se termine
toujours par l'identité du projet et une adresse où joindre une personne.
Chaque réponse porte la source et retrieved_at, que la licence demande
d'indiquer partout où les métadonnées sont montrées.
Ce MCP est un projet non officiel, sans affiliation à la Bibliothèque nationale
de France.
Confidentialité
Ce serveur ne collecte rien sur vous et n'envoie rien à son auteur. Il tourne sur
votre machine, ne joint que data.bnf.fr, 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
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. Les métadonnées appartiennent à la Bibliothèque
nationale de France, d'usage libre sous réserve d'indiquer la source et la date
de récupération.
