v1.10.0 — AMIRA MCP server

⚠️ Requires Node.js 20 or newer

This release raises the runtime floor from Node 18 to Node 20. If Claude Desktop
runs the extension on Node 18, it will fail to load after upgrading. Check with
node --version and update if you are below 20.

This is not our choice: the MCP TypeScript SDK v2, which this release migrates to,
requires Node 20+. Staying on Node 18 means staying on v1.9.2.

What's new

The server now speaks MCP 2026-07-28, the stateless revision ratified on 28 July.

• server/discover advertises ["2026-07-28"]
• Results carry resultType, and cacheable results carry real ttlMs / cacheScope
  (1 h public on tools/list, resources/list and server/discover; 24 h on
  resources/read) instead of the SDK's conservative { ttlMs: 0, private } default
• Both transports are covered — the bundled stdio entry and the remote Streamable
  HTTP endpoint

Existing clients keep working. Anything pinned to 2025-11-25 or earlier — including
the ChatGPT connector — negotiates exactly as it did before, answered by a fresh server
instance per request. No configuration change is needed.

Nothing changed in the data, the tools, or the citation contract: the same 26 tools on
stdio (28 over HTTP, with the OpenAI-compatible search/fetch), the same amira_url
on every record.

Under the hood

Migrated from the frozen @modelcontextprotocol/sdk v1 monolith to the scoped v2
packages (@modelcontextprotocol/server, /node, /client). Two gates were not
obvious and are worth recording for anyone doing the same migration: the modern era is
opt-in via supportedProtocolVersions, and the era is owned by the entry point
(serveStdio / createMcpHandler), not by the transport — a hand-connected transport
serves the 2025 era only, with server/discover answering -32601.

Verified on the wire on both transports with a raw JSON-RPC probe rather than the SDK
client. 48 unit tests, 10 live API tests, both smoke suites green.

See ROADMAP.md
for the full write-up.

Install

Download amira-mcp-server.mcpb below and open it with Claude Desktop. The extension
bundles a complete data snapshot, so it works offline; enable live refresh in the
extension settings to pull newer records from the public Omeka S API.

amira-mcp-skill.zip is the optional companion skill — unzip it into ~/.claude/skills/.

Full Changelog: v1.9.2...v1.10.0