@cyanheads/openlibrary-mcp-server 0.1.2 → 0.1.4

package/Dockerfile

@@ -38,7 +38,7 @@ ENV NODE_ENV=production
 
 # OCI image metadata (https://github.com/opencontainers/image-spec/blob/main/annotations.md)
 LABEL org.opencontainers.image.title="@cyanheads/openlibrary-mcp-server"
-LABEL org.opencontainers.image.description="MCP server for Open Library — search 20M+ books, fetch editions, authors, subjects, and cover images."
+LABEL org.opencontainers.image.description="Search books and authors, fetch editions, browse subjects, and resolve cover images from Open Library via MCP. STDIO or Streamable HTTP."
 LABEL org.opencontainers.image.licenses="Apache-2.0"
 LABEL org.opencontainers.image.source="https://github.com/cyanheads/openlibrary-mcp-server"
 

package/README.md

@@ -7,7 +7,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.1.2-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/openlibrary-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/openlibrary-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/openlibrary-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
+[![Version](https://img.shields.io/badge/Version-0.1.4-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/openlibrary-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/openlibrary-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/openlibrary-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 

package/package.json

@@ -1,42 +1,33 @@
 {
   "name": "@cyanheads/openlibrary-mcp-server",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "mcpName": "io.github.cyanheads/openlibrary-mcp-server",
-  "description": "MCP server for Open Library — search 20M+ books, fetch editions, authors, subjects, and cover images.",
+  "description": "Search books and authors, fetch editions, browse subjects, and resolve cover images from Open Library via MCP. STDIO or Streamable HTTP.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
     "openlibrary-mcp-server": "dist/index.js"
   },
-  "files": [
-    "changelog/",
-    "dist/",
-    "README.md",
-    "LICENSE",
-    "CLAUDE.md",
-    "AGENTS.md",
-    "Dockerfile",
-    "server.json"
-  ],
+  "files": ["dist/", "README.md", "LICENSE", "CLAUDE.md", "Dockerfile", "server.json"],
   "scripts": {
-    "build": "tsx scripts/build.ts",
-    "rebuild": "tsx scripts/clean.ts && tsx scripts/build.ts",
-    "clean": "tsx scripts/clean.ts",
-    "devcheck": "tsx scripts/devcheck.ts",
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run build",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "tree": "bun run scripts/tree.ts",
+    "format": "biome check --write --unsafe",
+    "test": "bunx vitest run",
     "audit:refresh": "rm -f bun.lock && bun install && bun audit",
-    "tree": "tsx scripts/tree.ts",
-    "list-skills": "tsx scripts/list-skills.ts",
-    "format": "biome check --write --unsafe .",
-    "lint:mcp": "tsx scripts/lint-mcp.ts",
-    "lint:packaging": "tsx scripts/lint-packaging.ts",
-    "bundle": "npm run build && npx -y @anthropic-ai/mcpb pack . dist/openlibrary-mcp-server.mcpb",
-    "changelog:build": "tsx scripts/build-changelog.ts",
-    "changelog:check": "tsx scripts/build-changelog.ts --check",
-    "test": "vitest run",
-    "start": "node dist/index.js",
-    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
-    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+    "list-skills": "bun run scripts/list-skills.ts",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/openlibrary-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js"
   },
   "keywords": [
     "mcp",
@@ -94,7 +85,6 @@
     "depcheck": "^1.4.7",
     "ignore": "^7.0.5",
     "tsc-alias": "^1.8.17",
-    "tsx": "^4.22.3",
     "typescript": "^6.0.3",
     "vitest": "^4.1.7"
   }

package/server.json

@@ -1,19 +1,19 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.cyanheads/openlibrary-mcp-server",
-  "description": "Read-only access to Open Library — 20M+ book editions, authors, subjects, and cover images.",
+  "description": "Search books and authors, fetch editions, browse subjects, and resolve cover images.",
   "repository": {
     "url": "https://github.com/cyanheads/openlibrary-mcp-server",
     "source": "github"
   },
-  "version": "0.1.2",
+  "version": "0.1.4",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/openlibrary-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.1.2",
+      "version": "0.1.4",
       "packageArguments": [
         {
           "type": "positional",
@@ -42,7 +42,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/openlibrary-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.1.2",
+      "version": "0.1.4",
       "packageArguments": [
         {
           "type": "positional",
@@ -75,6 +75,12 @@
           "isRequired": false,
           "default": "/mcp"
         },
+        {
+          "name": "MCP_PUBLIC_URL",
+          "description": "Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).",
+          "format": "string",
+          "isRequired": false
+        },
         {
           "name": "MCP_AUTH_MODE",
           "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",

package/changelog/0.1.x/0.1.0.md

@@ -1,22 +0,0 @@
----
-summary: "Initial release — 9 tools and 2 resources for Open Library book search, editions, authors, subjects, and cover images"
-breaking: false
-security: false
----
-
-# 0.1.0 — 2026-05-23
-
-## Added
-
-- **`openlibrary_search_books`** — full-text book search with field filters (title, author, subject, publisher, ISBN, language), sort options, pagination, and optional live Internet Archive reading availability
-- **`openlibrary_get_work`** — fetch work detail by Open Library Work ID (OL…W): title, description, subjects, cover IDs, and author IDs
-- **`openlibrary_get_editions`** — list editions of a work with ISBNs, publisher, language, page count, and edition OLIDs
-- **`openlibrary_get_edition`** — fetch a single edition by ISBN-10, ISBN-13, OCLC, LCCN, or Open Library Edition ID
-- **`openlibrary_search_authors`** — search authors by name; returns Author IDs, birth/death dates, top works, and subject associations
-- **`openlibrary_get_author`** — fetch author detail by Open Library Author ID (OL…A): bio, dates, photo IDs, and linked Wikidata/VIAF/ISNI/Goodreads/LibraryThing identifiers
-- **`openlibrary_get_author_works`** — list works by an author with titles, cover IDs, and Work OLIDs
-- **`openlibrary_get_subject`** — browse works by subject tag with edition counts, cover IDs, and total work count
-- **`openlibrary_get_cover_url`** — resolve a cover image URL for a book or author photo in S/M/L size
-- **`openlibrary://works/{work_id}`** resource — work detail as injectable conversation context
-- **`openlibrary://authors/{author_id}`** resource — author detail as injectable conversation context
-- `OPENLIBRARY_USER_AGENT` env var for configuring the User-Agent header sent with all Open Library API requests

package/changelog/0.1.x/0.1.1.md

@@ -1,25 +0,0 @@
----
-summary: "Post-launch patch — full Open Library implementation: 9 tools, 2 resources, 11 test files, agent-facing docs and audit"
-breaking: false
-security: false
----
-
-# 0.1.1 — 2026-05-23
-
-## Added
-
-- **`openlibrary_search_books`** — full-text book search with field filters, sort options, pagination, and optional Internet Archive reading-availability lookup
-- **`openlibrary_get_work`** — fetch work detail by Open Library Work ID (OL…W)
-- **`openlibrary_get_editions`** — list editions of a work with ISBNs, publisher, language, and page count
-- **`openlibrary_get_edition`** — fetch a single edition by ISBN-10, ISBN-13, OCLC, LCCN, or Open Library Edition ID (OL…M)
-- **`openlibrary_search_authors`** — search authors by name; returns Author IDs, birth/death dates, top works, and subject associations
-- **`openlibrary_get_author`** — fetch author detail by Open Library Author ID (OL…A) with bio, dates, photo IDs, and external identifiers (Wikidata, VIAF, ISNI, Goodreads, LibraryThing)
-- **`openlibrary_get_author_works`** — list works by an author with titles, cover IDs, and Work OLIDs
-- **`openlibrary_get_subject`** — browse works by subject tag with edition counts, cover IDs, and total work count
-- **`openlibrary_get_cover_url`** — resolve a cover image URL for a book or author photo in S/M/L size
-- **`openlibrary://works/{work_id}`** resource — work detail as injectable conversation context
-- **`openlibrary://authors/{author_id}`** resource — author detail as injectable conversation context
-- **`OPENLIBRARY_USER_AGENT`** env var for configuring the User-Agent header sent with all Open Library API requests
-- Full test suite — 11 test files covering all tools and resources
-- `manifest.json` for MCPB bundle support (Claude Desktop one-click install)
-- Install badges for Claude Desktop, Cursor, and VS Code

package/changelog/0.1.x/0.1.2.md

@@ -1,14 +0,0 @@
----
-summary: "Metadata polish — server.json name, runtimeHint, Dockerfile OCI labels, package.json fields, bunfig.toml"
-breaking: false
-security: false
----
-
-# 0.1.2 — 2026-05-23
-
-## Changed
-
-- **`server.json`** `name` corrected to `io.github.cyanheads/openlibrary-mcp-server`; `runtimeHint` updated `node` → `bun` on both transport entries
-- **`package.json`** `mcpName`, `bugs`, `homepage`, `author`, `funding`, `packageManager` added; `repository.url` corrected to `git+https://...git`; keywords expanded with `typescript`, `bun`, `stdio`, `streamable-http`, `ai-agent`
-- **`Dockerfile`** OCI labels `title`, `description`, and `source` filled in
-- **`bunfig.toml`** added (`auto=fallback`, `bun=true`)

package/changelog/template.md

@@ -1,119 +0,0 @@
----
-# FORMAT REFERENCE — do not edit. Copy this file to
-# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
-# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
-# with a concrete date.
-
-# Required. One-line GitHub Release-style headline. 350 character cap.
-# Default short and scannable. Don't pad, don't stitch unrelated changes with
-# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
-# inside the value as a key separator and fails GitHub's strict parser.
-summary: ""
-
-# Set `true` when consumers must change code to upgrade: API removals,
-# signature changes, config renames, behavior changes that break existing
-# usage. Flagged as `Breaking` in the rollup.
-breaking: false
-
-# Set `true` if this release contains any security fix. Pairs with the
-# `## Security` section below. Flagged as `Security` in the rollup so
-# users can triage upgrade urgency at a glance.
-security: false
----
-
-# <version> — YYYY-MM-DD
-
-<!--
-  AUTHORING GUIDE — applies to the new per-version file you create from this
-  template.
-
-  Audience: someone scanning release notes to decide what affects them. Lead
-  each bullet with the symbol or concept name in **bold** so they can skip
-  what's irrelevant and zoom in on what's not.
-
-  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
-  name the symbol, state what changed, stop. Use a second sentence only when
-  it carries weight. If a bullet feels long, it is.
-
-  Cut: mechanism walkthroughs (those belong in JSDoc, AGENTS.md, or the
-  relevant skill), ceremonial framings ("This release introduces…",
-  backwards-compat paragraphs), file-by-file test enumerations, internal
-  implementation notes. Prefer code/symbol names over English re-explanations.
-
-  Narrative intro: skip by default. Add one short sentence only when the
-  release theme genuinely needs framing the bullets can't carry.
-
-  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
-  Fixed, Security. Include only sections with entries; delete the rest
-  (including the commented-out scaffolding below). Don't ship empty headers.
-
-  Include: every distinct fact a reader needs to adopt or audit the release —
-  new exports, signatures, lint rule IDs, env vars, breaking changes, version
-  bumps on shipped skills. Nothing more.
-
-  Links: link issues, PRs, docs, or skills where they help a reader jump to
-  context. Once per item per entry — don't re-link the same issue in summary,
-  narrative, and bullet. Skip links for inline symbol names; code spans speak
-  for themselves.
-
-  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
-  inside its own UI, not in npm reads or local editors.
-
-      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
-      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
-
-  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
-  Never speculate on a future number — `#42` for an upcoming PR silently
-  resolves to whatever real item already owns 42, and timeline previews pull
-  in that unrelated item's metadata.
-
-  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
-  via `gh release create --notes-from-tag`. The tag is a derivative of this
-  changelog entry — a condensed, scannable version, not a copy. Format:
-
-    <theme — omit version number, GitHub prepends it>
-                                                          ← blank line
-    <1-2 sentence context: what this release does>
-                                                          ← blank line
-    Dependency bumps:                                     ← section header
-                                                          ← blank line
-    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
-                                                          ← blank line
-    Changed:                                              ← only sections with entries
-                                                          ← blank line
-    - `format()` output includes `query` in text mode
-                                                          ← blank line
-    Added:
-                                                          ← blank line
-    - `manifest.json` scaffolded for MCPB bundle support
-    - Install badges (Claude Desktop, Cursor, VS Code)
-                                                          ← blank line
-    <N> tests pass; `bun run devcheck` clean.             ← footer
-
-  Never a flat comma-separated string. Always structured markdown with
-  sections. The tag must scan well as a rendered GitHub Release page.
--->
-
-## Added
-
--
-
-## Changed
-
--
-
-<!-- ## Deprecated
-
-- -->
-
-<!-- ## Removed
-
-- -->
-
-## Fixed
-
--
-
-<!-- ## Security
-
-- -->