mcp-databnf

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

Claude Code

claude mcp add databnf -- npx -y mcp-databnf

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

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

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

With Docker

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

-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.1.2.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.

import { BnfClient } from "mcp-databnf/client";

const client = new BnfClient();
const { data, cached } = await client.getAuthor("cb11907966z");
console.log(data.label, cached);

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

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 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

Claude Code

claude mcp add databnf -- npx -y mcp-databnf

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

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

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

Avec Docker

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

-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.1.2.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é.

import { BnfClient } from "mcp-databnf/client";

const client = new BnfClient();
const { data, cached } = await client.getAuthor("cb11907966z");
console.log(data.label, cached);

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

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. 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.