mcp-databnf 1.1.1 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 2.0.0
+
+- **This server now needs node 24 or later.** Node 20 reached its end of
+  support on 2026-04-30 and node 22 is no longer what this code is built and
+  typed against. That is what makes this a major version: an install on an
+  older node is refused rather than left to fail somewhere later.
+- **Every refusal of an argument opens with `invalid_input`.** A value outside
+  its bounds, of the wrong type, or outside the set an argument reads used to
+  come back in the validator's own words, with no code to branch on.
+- **A container image is published for each version**, on ghcr, for amd64 and
+  arm64. The readme carries the configuration that runs it.
+- The published package carries its changelog, and the entry point it declares
+  for the package root now publishes its types.
+
 This project follows [semantic versioning](https://semver.org/).
 
 ## 1.1.1

package/README.md

@@ -5,6 +5,7 @@
 [![license](https://img.shields.io/npm/l/mcp-databnf.svg)](./LICENSE)
 [![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-6E56CF)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.smeet666/mcp-databnf)
 [![Glama](https://glama.ai/mcp/servers/smeet666/mcp-databnf/badges/score.svg)](https://glama.ai/mcp/servers/smeet666/mcp-databnf)
+[![M8ven](https://m8ven.ai/badge/mcp/smeet666-mcp-databnf-abxqfo?variant=verified)](https://m8ven.ai/mcp/smeet666-mcp-databnf-abxqfo)
 [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=databnf&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1kYXRhYm5mIl19)
 [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=databnf&config=%7B%22name%22%3A%22databnf%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-databnf%22%5D%7D)
 
@@ -47,6 +48,23 @@ npx mcp-databnf
 }
 ```
 
+### With Docker
+
+```json
+{
+  "mcpServers": {
+    "databnf": {
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-databnf:2.0.0"]
+    }
+  }
+}
+```
+
+`-i` keeps stdin open, which is where the protocol travels, and no `-t` is
+passed: a TTY rewrites the stream and breaks it. The container needs outbound
+HTTPS to `data.bnf.fr`, `catalogue.bnf.fr` and `isni.org`, and nothing else: no volume, no port, no environment variable, no credential.
+
 ## The seven tools
 
 | Tool             | Answers                                                                                                                   |
@@ -272,6 +290,24 @@ npx mcp-databnf
 }
 ```
 
+### Avec Docker
+
+```json
+{
+  "mcpServers": {
+    "databnf": {
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-databnf:2.0.0"]
+    }
+  }
+}
+```
+
+`-i` garde l'entrée standard ouverte, qui est le canal du protocole, et aucun
+`-t` n'est passé : un terminal réécrit le flux et le casse. Le conteneur a besoin
+d'un accès HTTPS sortant vers `data.bnf.fr`, `catalogue.bnf.fr` et `isni.org`, et de rien d'autre :
+aucun volume, aucun port, aucune variable d'environnement, aucun identifiant.
+
 ## Les sept outils
 
 | Outil            | Répond à                                                                                                               |

package/dist/bnf/client.d.ts

@@ -18,10 +18,10 @@ interface Config {
     logLevel: LogLevel;
 }
 interface Logger {
-    debug(message: string): void;
-    info(message: string): void;
-    warn(message: string): void;
-    error(message: string): void;
+    debug: (message: string) => void;
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
 }
 
 /** The shapes the access layer produces. Nothing here knows about MCP. */
@@ -244,17 +244,6 @@ interface Page<T> {
     indexWindowFull?: boolean | null;
 }
 
-/** How a piece of caller text became the terms the index was given. */
-interface SearchReading {
-    /** The words the text was cut into, each one quoted into the query. */
-    words: string[];
-    /** The terms the index requires, after it splits inside a word. */
-    terms: string[];
-    /** The characters that marked nothing and were removed before the cutting. */
-    invisible: string[];
-    /** The visible characters that reached no term. */
-    setAside: string[];
-}
 type EntityKind = "ark" | "temp-work";
 interface EntityId {
     kind: EntityKind;
@@ -318,7 +307,6 @@ declare class BnfClient {
     /** The deadline one query is given, which callers report rather than guess. */
     get timeoutMs(): number;
     /** The one address this client sends anything to. */
-    get endpoint(): string;
     /**
      * `cacheKey` is stated rather than taken from the query, because two reads of
      * one query can produce different values: a list cut to five rows is not the
@@ -328,24 +316,7 @@ declare class BnfClient {
     private read;
     private fetchAndParse;
     /** Read an identifier a caller wrote, refusing anything this dataset cannot address. */
-    identify(input: string): EntityId;
     /** The words a search will actually look for, which a tool reports back. */
-    words(input: string): string[];
-    /**
-     * The terms the index requires, which is what a row's presence rests on.
-     *
-     * The index splits inside a word at an apostrophe and at a hyphen, so a word
-     * a caller wrote as one can reach it as two, each required on its own.
-     */
-    indexTerms(words: readonly string[]): string[];
-    /**
-     * How a piece of caller text became the terms the search was run with.
-     *
-     * A tool reports the reading back, so the same reading has to be the one the
-     * query was built from: the words, the terms the index makes of them, and
-     * the characters that reached neither.
-     */
-    searchReading(input: string): SearchReading;
     searchAuthors(name: string, limit: number, offset: number): Promise<Read<Page<AuthorSummary>>>;
     getAuthor(id: EntityId): Promise<Read<AuthorDetail>>;
     /**