mcp-libraryofcongress 2.1.1 → 3.0.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 3.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.
+
+## 2.1.2
+
+- A search the Library could not run is reported as a failure instead of as an
+  empty catalogue. Under load the site answers with a rendered page holding no
+  rows and a pagination block counting zero results, written in exactly the
+  words a search that genuinely matched nothing is written in: the collections
+  listing, which holds 584 collections and takes no query at all, came back as
+  `of: 0` beside an empty `results`, and the server published that as the
+  Library having gathered no collection. What separates the two is what the site
+  says about keeping the answer. A search it stands behind may be kept for a
+  day; the page it renders while its search is failing carries `no-cache` and a
+  lifetime of zero. A count of zero read off such a page is now `rate_limited`,
+  which says the site could not answer and says nothing about what the Library
+  holds. The catalogue, newspaper and collections searches all read their count
+  from that block, so all three are covered. A search that really matches
+  nothing still answers with a count of zero.
+- The nightly live canary tells a contract that moved apart from a site that
+  could not answer. A route that came back rate limited, unreachable or out of
+  time leaves that case out of the run and names it on stderr, so only an answer
+  this server could not read fails the canary and opens an issue. Each assertion
+  states the field or the behaviour it holds the site to.
+
 ## 2.1.1
 
 - The README carries the same badge row as every server here: npm, CI, the

package/README.md

@@ -5,8 +5,10 @@
 [![license](https://img.shields.io/npm/l/mcp-libraryofcongress.svg)](./LICENSE)
 [![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-6E56CF)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.smeet666/mcp-libraryofcongress)
 [![Glama](https://glama.ai/mcp/servers/smeet666/mcp-libraryofcongress/badges/score.svg)](https://glama.ai/mcp/servers/smeet666/mcp-libraryofcongress)
+[![M8ven](https://m8ven.ai/badge/mcp/smeet666-mcp-libraryofcongress-1rr3lc?variant=verified)](https://m8ven.ai/mcp/smeet666-mcp-libraryofcongress-1rr3lc)
 [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=libraryofcongress&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1saWJyYXJ5b2Zjb25ncmVzcyJdfQ%3D%3D)
 [![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=libraryofcongress&config=%7B%22name%22%3A%22libraryofcongress%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-libraryofcongress%22%5D%7D)
+<!-- m8ven-verify: 69c0541bf1d6a6e94b450b4d2b058659 -->
 
 An MCP server for the [Library of Congress](https://www.loc.gov). **Search the
 text scanned off digitised American newspaper pages**, search the catalogue by
@@ -41,7 +43,24 @@ claude mcp add libraryofcongress -- npx -y mcp-libraryofcongress
 }
 ```
 
-Node 20 or later.
+### With Docker
+
+```json
+{
+  "mcpServers": {
+    "libraryofcongress": {
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-libraryofcongress:3.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 `www.loc.gov` and `lccn.loc.gov`, and nothing else: no volume, no port, no environment variable, no credential.
+
+Node 24 or later.
 
 **Bundle, without npm**
 
@@ -299,8 +318,11 @@ console.log(data.paging.resultCount, data.hits[0]?.sourceUrl);
 ## Troubleshooting
 
 **`rate_limited`.** The site asked this client to slow down, or this server was
-asked for more than its pacing allows. It says nothing about whether the Library
-holds what you asked for. Wait and ask again.
+asked for more than its pacing allows. It also covers a search the site could
+not run: it answers then with a page holding no rows and refuses to have that
+page kept, and a count of nothing read off it would say the Library holds
+nothing. It says nothing about whether the Library holds what you asked for.
+Wait and ask again.
 
 **`parse_failure`.** A response arrived in a shape this server cannot read,
 which includes a long answer cut off in transit. It usually means a route
@@ -391,7 +413,25 @@ claude mcp add libraryofcongress -- npx -y mcp-libraryofcongress
 }
 ```
 
-Node 20 ou plus récent.
+### Avec Docker
+
+```json
+{
+  "mcpServers": {
+    "libraryofcongress": {
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-libraryofcongress:3.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 `www.loc.gov` et `lccn.loc.gov`, et de rien d'autre :
+aucun volume, aucun port, aucune variable d'environnement, aucun identifiant.
+
+Node 24 ou plus récent.
 
 **Bundle, sans npm**
 
@@ -659,7 +699,10 @@ console.log(data.paging.resultCount, data.hits[0]?.sourceUrl);
 ## Dépannage
 
 **`rate_limited`.** Le site demande à ce client de ralentir, ou ce serveur a été
-sollicité au-delà de sa cadence. Cela ne dit rien de ce que la Library conserve.
+sollicité au-delà de sa cadence. Ce code couvre aussi une recherche que le site
+n'a pas pu exécuter : il répond alors par une page sans aucune ligne et refuse
+qu'elle soit conservée, et un compte de zéro lu sur cette page affirmerait que
+la Library ne conserve rien. Cela ne dit rien de ce que la Library conserve.
 Attendez et redemandez.
 
 **`parse_failure`.** Une réponse est arrivée dans une forme illisible pour ce