@cyanheads/openlibrary-mcp-server 0.1.3 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/Dockerfile +1 -1
- package/README.md +1 -1
- package/package.json +18 -28
- package/server.json +9 -3
- package/changelog/0.1.x/0.1.0.md +0 -22
- package/changelog/0.1.x/0.1.1.md +0 -25
- package/changelog/0.1.x/0.1.2.md +0 -14
- package/changelog/0.1.x/0.1.3.md +0 -11
- package/changelog/template.md +0 -119
package/Dockerfile
CHANGED
|
@@ -38,7 +38,7 @@ ENV NODE_ENV=production
|
|
|
38
38
|
|
|
39
39
|
# OCI image metadata (https://github.com/opencontainers/image-spec/blob/main/annotations.md)
|
|
40
40
|
LABEL org.opencontainers.image.title="@cyanheads/openlibrary-mcp-server"
|
|
41
|
-
LABEL org.opencontainers.image.description="
|
|
41
|
+
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."
|
|
42
42
|
LABEL org.opencontainers.image.licenses="Apache-2.0"
|
|
43
43
|
LABEL org.opencontainers.image.source="https://github.com/cyanheads/openlibrary-mcp-server"
|
|
44
44
|
|
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
|
|
8
8
|
<div align="center">
|
|
9
9
|
|
|
10
|
-
[](./CHANGELOG.md) [](./LICENSE) [](https://github.com/users/cyanheads/packages/container/package/openlibrary-mcp-server) [](https://modelcontextprotocol.io/) [](https://www.npmjs.com/package/@cyanheads/openlibrary-mcp-server) [](https://www.typescriptlang.org/) [](https://bun.sh/)
|
|
11
11
|
|
|
12
12
|
</div>
|
|
13
13
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cyanheads/openlibrary-mcp-server",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"mcpName": "io.github.cyanheads/openlibrary-mcp-server",
|
|
5
5
|
"description": "Search books and authors, fetch editions, browse subjects, and resolve cover images from Open Library via MCP. STDIO or Streamable HTTP.",
|
|
6
6
|
"type": "module",
|
|
@@ -9,35 +9,25 @@
|
|
|
9
9
|
"bin": {
|
|
10
10
|
"openlibrary-mcp-server": "dist/index.js"
|
|
11
11
|
},
|
|
12
|
-
"files": [
|
|
13
|
-
"changelog/",
|
|
14
|
-
"dist/",
|
|
15
|
-
"README.md",
|
|
16
|
-
"LICENSE",
|
|
17
|
-
"CLAUDE.md",
|
|
18
|
-
"AGENTS.md",
|
|
19
|
-
"Dockerfile",
|
|
20
|
-
"server.json"
|
|
21
|
-
],
|
|
12
|
+
"files": ["dist/", "README.md", "LICENSE", "CLAUDE.md", "Dockerfile", "server.json"],
|
|
22
13
|
"scripts": {
|
|
23
|
-
"build": "bun scripts/build.ts",
|
|
24
|
-
"rebuild": "bun scripts/clean.ts && bun
|
|
25
|
-
"clean": "bun scripts/clean.ts",
|
|
26
|
-
"devcheck": "bun scripts/devcheck.ts",
|
|
14
|
+
"build": "bun run scripts/build.ts",
|
|
15
|
+
"rebuild": "bun run scripts/clean.ts && bun run build",
|
|
16
|
+
"clean": "bun run scripts/clean.ts",
|
|
17
|
+
"devcheck": "bun run scripts/devcheck.ts",
|
|
18
|
+
"tree": "bun run scripts/tree.ts",
|
|
19
|
+
"format": "biome check --write --unsafe",
|
|
20
|
+
"test": "bunx vitest run",
|
|
27
21
|
"audit:refresh": "rm -f bun.lock && bun install && bun audit",
|
|
28
|
-
"
|
|
29
|
-
"
|
|
30
|
-
"
|
|
31
|
-
"
|
|
32
|
-
"
|
|
33
|
-
"
|
|
34
|
-
"
|
|
35
|
-
"
|
|
36
|
-
"
|
|
37
|
-
"start": "node dist/index.js",
|
|
38
|
-
"start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
|
|
39
|
-
"start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js",
|
|
40
|
-
"publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish"
|
|
22
|
+
"list-skills": "bun run scripts/list-skills.ts",
|
|
23
|
+
"lint:mcp": "bun run scripts/lint-mcp.ts",
|
|
24
|
+
"lint:packaging": "bun run scripts/lint-packaging.ts",
|
|
25
|
+
"bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/openlibrary-mcp-server.mcpb",
|
|
26
|
+
"changelog:build": "bun run scripts/build-changelog.ts",
|
|
27
|
+
"changelog:check": "bun run scripts/build-changelog.ts --check",
|
|
28
|
+
"publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
|
|
29
|
+
"start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
|
|
30
|
+
"start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js"
|
|
41
31
|
},
|
|
42
32
|
"keywords": [
|
|
43
33
|
"mcp",
|
package/server.json
CHANGED
|
@@ -6,14 +6,14 @@
|
|
|
6
6
|
"url": "https://github.com/cyanheads/openlibrary-mcp-server",
|
|
7
7
|
"source": "github"
|
|
8
8
|
},
|
|
9
|
-
"version": "0.1.
|
|
9
|
+
"version": "0.1.4",
|
|
10
10
|
"packages": [
|
|
11
11
|
{
|
|
12
12
|
"registryType": "npm",
|
|
13
13
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
14
14
|
"identifier": "@cyanheads/openlibrary-mcp-server",
|
|
15
15
|
"runtimeHint": "bun",
|
|
16
|
-
"version": "0.1.
|
|
16
|
+
"version": "0.1.4",
|
|
17
17
|
"packageArguments": [
|
|
18
18
|
{
|
|
19
19
|
"type": "positional",
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
43
43
|
"identifier": "@cyanheads/openlibrary-mcp-server",
|
|
44
44
|
"runtimeHint": "bun",
|
|
45
|
-
"version": "0.1.
|
|
45
|
+
"version": "0.1.4",
|
|
46
46
|
"packageArguments": [
|
|
47
47
|
{
|
|
48
48
|
"type": "positional",
|
|
@@ -75,6 +75,12 @@
|
|
|
75
75
|
"isRequired": false,
|
|
76
76
|
"default": "/mcp"
|
|
77
77
|
},
|
|
78
|
+
{
|
|
79
|
+
"name": "MCP_PUBLIC_URL",
|
|
80
|
+
"description": "Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).",
|
|
81
|
+
"format": "string",
|
|
82
|
+
"isRequired": false
|
|
83
|
+
},
|
|
78
84
|
{
|
|
79
85
|
"name": "MCP_AUTH_MODE",
|
|
80
86
|
"description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
|
package/changelog/0.1.x/0.1.0.md
DELETED
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
summary: "Initial release — 9 tools and 2 resources for Open Library book search, editions, authors, subjects, and cover images"
|
|
3
|
-
breaking: false
|
|
4
|
-
security: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# 0.1.0 — 2026-05-23
|
|
8
|
-
|
|
9
|
-
## Added
|
|
10
|
-
|
|
11
|
-
- **`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
|
|
12
|
-
- **`openlibrary_get_work`** — fetch work detail by Open Library Work ID (OL…W): title, description, subjects, cover IDs, and author IDs
|
|
13
|
-
- **`openlibrary_get_editions`** — list editions of a work with ISBNs, publisher, language, page count, and edition OLIDs
|
|
14
|
-
- **`openlibrary_get_edition`** — fetch a single edition by ISBN-10, ISBN-13, OCLC, LCCN, or Open Library Edition ID
|
|
15
|
-
- **`openlibrary_search_authors`** — search authors by name; returns Author IDs, birth/death dates, top works, and subject associations
|
|
16
|
-
- **`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
|
|
17
|
-
- **`openlibrary_get_author_works`** — list works by an author with titles, cover IDs, and Work OLIDs
|
|
18
|
-
- **`openlibrary_get_subject`** — browse works by subject tag with edition counts, cover IDs, and total work count
|
|
19
|
-
- **`openlibrary_get_cover_url`** — resolve a cover image URL for a book or author photo in S/M/L size
|
|
20
|
-
- **`openlibrary://works/{work_id}`** resource — work detail as injectable conversation context
|
|
21
|
-
- **`openlibrary://authors/{author_id}`** resource — author detail as injectable conversation context
|
|
22
|
-
- `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
DELETED
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
summary: "Post-launch patch — full Open Library implementation: 9 tools, 2 resources, 11 test files, agent-facing docs and audit"
|
|
3
|
-
breaking: false
|
|
4
|
-
security: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# 0.1.1 — 2026-05-23
|
|
8
|
-
|
|
9
|
-
## Added
|
|
10
|
-
|
|
11
|
-
- **`openlibrary_search_books`** — full-text book search with field filters, sort options, pagination, and optional Internet Archive reading-availability lookup
|
|
12
|
-
- **`openlibrary_get_work`** — fetch work detail by Open Library Work ID (OL…W)
|
|
13
|
-
- **`openlibrary_get_editions`** — list editions of a work with ISBNs, publisher, language, and page count
|
|
14
|
-
- **`openlibrary_get_edition`** — fetch a single edition by ISBN-10, ISBN-13, OCLC, LCCN, or Open Library Edition ID (OL…M)
|
|
15
|
-
- **`openlibrary_search_authors`** — search authors by name; returns Author IDs, birth/death dates, top works, and subject associations
|
|
16
|
-
- **`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)
|
|
17
|
-
- **`openlibrary_get_author_works`** — list works by an author with titles, cover IDs, and Work OLIDs
|
|
18
|
-
- **`openlibrary_get_subject`** — browse works by subject tag with edition counts, cover IDs, and total work count
|
|
19
|
-
- **`openlibrary_get_cover_url`** — resolve a cover image URL for a book or author photo in S/M/L size
|
|
20
|
-
- **`openlibrary://works/{work_id}`** resource — work detail as injectable conversation context
|
|
21
|
-
- **`openlibrary://authors/{author_id}`** resource — author detail as injectable conversation context
|
|
22
|
-
- **`OPENLIBRARY_USER_AGENT`** env var for configuring the User-Agent header sent with all Open Library API requests
|
|
23
|
-
- Full test suite — 11 test files covering all tools and resources
|
|
24
|
-
- `manifest.json` for MCPB bundle support (Claude Desktop one-click install)
|
|
25
|
-
- Install badges for Claude Desktop, Cursor, and VS Code
|
package/changelog/0.1.x/0.1.2.md
DELETED
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
summary: "Metadata polish — server.json name, runtimeHint, Dockerfile OCI labels, package.json fields, bunfig.toml"
|
|
3
|
-
breaking: false
|
|
4
|
-
security: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# 0.1.2 — 2026-05-23
|
|
8
|
-
|
|
9
|
-
## Changed
|
|
10
|
-
|
|
11
|
-
- **`server.json`** `name` corrected to `io.github.cyanheads/openlibrary-mcp-server`; `runtimeHint` updated `node` → `bun` on both transport entries
|
|
12
|
-
- **`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`
|
|
13
|
-
- **`Dockerfile`** OCI labels `title`, `description`, and `source` filled in
|
|
14
|
-
- **`bunfig.toml`** added (`auto=fallback`, `bun=true`)
|
package/changelog/0.1.x/0.1.3.md
DELETED
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
summary: "Tagline sync — description updated across package.json, server.json, manifest.json, README, and GitHub repository"
|
|
3
|
-
breaking: false
|
|
4
|
-
security: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# 0.1.3 — 2026-05-23
|
|
8
|
-
|
|
9
|
-
## Changed
|
|
10
|
-
|
|
11
|
-
- **Description** synced to canonical tagline across all five surfaces: `package.json`, `server.json`, `manifest.json`, `README.md`, and the GitHub repository description
|
package/changelog/template.md
DELETED
|
@@ -1,119 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
# FORMAT REFERENCE — do not edit. Copy this file to
|
|
3
|
-
# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
|
|
4
|
-
# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
|
|
5
|
-
# with a concrete date.
|
|
6
|
-
|
|
7
|
-
# Required. One-line GitHub Release-style headline. 350 character cap.
|
|
8
|
-
# Default short and scannable. Don't pad, don't stitch unrelated changes with
|
|
9
|
-
# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
|
|
10
|
-
# inside the value as a key separator and fails GitHub's strict parser.
|
|
11
|
-
summary: ""
|
|
12
|
-
|
|
13
|
-
# Set `true` when consumers must change code to upgrade: API removals,
|
|
14
|
-
# signature changes, config renames, behavior changes that break existing
|
|
15
|
-
# usage. Flagged as `Breaking` in the rollup.
|
|
16
|
-
breaking: false
|
|
17
|
-
|
|
18
|
-
# Set `true` if this release contains any security fix. Pairs with the
|
|
19
|
-
# `## Security` section below. Flagged as `Security` in the rollup so
|
|
20
|
-
# users can triage upgrade urgency at a glance.
|
|
21
|
-
security: false
|
|
22
|
-
---
|
|
23
|
-
|
|
24
|
-
# <version> — YYYY-MM-DD
|
|
25
|
-
|
|
26
|
-
<!--
|
|
27
|
-
AUTHORING GUIDE — applies to the new per-version file you create from this
|
|
28
|
-
template.
|
|
29
|
-
|
|
30
|
-
Audience: someone scanning release notes to decide what affects them. Lead
|
|
31
|
-
each bullet with the symbol or concept name in **bold** so they can skip
|
|
32
|
-
what's irrelevant and zoom in on what's not.
|
|
33
|
-
|
|
34
|
-
Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
|
|
35
|
-
name the symbol, state what changed, stop. Use a second sentence only when
|
|
36
|
-
it carries weight. If a bullet feels long, it is.
|
|
37
|
-
|
|
38
|
-
Cut: mechanism walkthroughs (those belong in JSDoc, AGENTS.md, or the
|
|
39
|
-
relevant skill), ceremonial framings ("This release introduces…",
|
|
40
|
-
backwards-compat paragraphs), file-by-file test enumerations, internal
|
|
41
|
-
implementation notes. Prefer code/symbol names over English re-explanations.
|
|
42
|
-
|
|
43
|
-
Narrative intro: skip by default. Add one short sentence only when the
|
|
44
|
-
release theme genuinely needs framing the bullets can't carry.
|
|
45
|
-
|
|
46
|
-
Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
|
|
47
|
-
Fixed, Security. Include only sections with entries; delete the rest
|
|
48
|
-
(including the commented-out scaffolding below). Don't ship empty headers.
|
|
49
|
-
|
|
50
|
-
Include: every distinct fact a reader needs to adopt or audit the release —
|
|
51
|
-
new exports, signatures, lint rule IDs, env vars, breaking changes, version
|
|
52
|
-
bumps on shipped skills. Nothing more.
|
|
53
|
-
|
|
54
|
-
Links: link issues, PRs, docs, or skills where they help a reader jump to
|
|
55
|
-
context. Once per item per entry — don't re-link the same issue in summary,
|
|
56
|
-
narrative, and bullet. Skip links for inline symbol names; code spans speak
|
|
57
|
-
for themselves.
|
|
58
|
-
|
|
59
|
-
Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
|
|
60
|
-
inside its own UI, not in npm reads or local editors.
|
|
61
|
-
|
|
62
|
-
[#38](https://github.com/cyanheads/mcp-ts-core/issues/38) ← issue
|
|
63
|
-
[#42](https://github.com/cyanheads/mcp-ts-core/pull/42) ← PR
|
|
64
|
-
|
|
65
|
-
Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
|
|
66
|
-
Never speculate on a future number — `#42` for an upcoming PR silently
|
|
67
|
-
resolves to whatever real item already owns 42, and timeline previews pull
|
|
68
|
-
in that unrelated item's metadata.
|
|
69
|
-
|
|
70
|
-
TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
|
|
71
|
-
via `gh release create --notes-from-tag`. The tag is a derivative of this
|
|
72
|
-
changelog entry — a condensed, scannable version, not a copy. Format:
|
|
73
|
-
|
|
74
|
-
<theme — omit version number, GitHub prepends it>
|
|
75
|
-
← blank line
|
|
76
|
-
<1-2 sentence context: what this release does>
|
|
77
|
-
← blank line
|
|
78
|
-
Dependency bumps: ← section header
|
|
79
|
-
← blank line
|
|
80
|
-
- `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6 ← bullet
|
|
81
|
-
← blank line
|
|
82
|
-
Changed: ← only sections with entries
|
|
83
|
-
← blank line
|
|
84
|
-
- `format()` output includes `query` in text mode
|
|
85
|
-
← blank line
|
|
86
|
-
Added:
|
|
87
|
-
← blank line
|
|
88
|
-
- `manifest.json` scaffolded for MCPB bundle support
|
|
89
|
-
- Install badges (Claude Desktop, Cursor, VS Code)
|
|
90
|
-
← blank line
|
|
91
|
-
<N> tests pass; `bun run devcheck` clean. ← footer
|
|
92
|
-
|
|
93
|
-
Never a flat comma-separated string. Always structured markdown with
|
|
94
|
-
sections. The tag must scan well as a rendered GitHub Release page.
|
|
95
|
-
-->
|
|
96
|
-
|
|
97
|
-
## Added
|
|
98
|
-
|
|
99
|
-
-
|
|
100
|
-
|
|
101
|
-
## Changed
|
|
102
|
-
|
|
103
|
-
-
|
|
104
|
-
|
|
105
|
-
<!-- ## Deprecated
|
|
106
|
-
|
|
107
|
-
- -->
|
|
108
|
-
|
|
109
|
-
<!-- ## Removed
|
|
110
|
-
|
|
111
|
-
- -->
|
|
112
|
-
|
|
113
|
-
## Fixed
|
|
114
|
-
|
|
115
|
-
-
|
|
116
|
-
|
|
117
|
-
<!-- ## Security
|
|
118
|
-
|
|
119
|
-
- -->
|