@cyanheads/openlibrary-mcp-server 0.1.1

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.
Files changed (69) hide show
  1. package/CLAUDE.md +391 -0
  2. package/Dockerfile +98 -0
  3. package/LICENSE +201 -0
  4. package/README.md +316 -0
  5. package/changelog/0.1.x/0.1.0.md +22 -0
  6. package/changelog/0.1.x/0.1.1.md +25 -0
  7. package/changelog/template.md +119 -0
  8. package/dist/config/server-config.d.ts +11 -0
  9. package/dist/config/server-config.d.ts.map +1 -0
  10. package/dist/config/server-config.js +20 -0
  11. package/dist/config/server-config.js.map +1 -0
  12. package/dist/index.d.ts +7 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +38 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/mcp-server/resources/definitions/openlibrary-author.resource.d.ts +25 -0
  17. package/dist/mcp-server/resources/definitions/openlibrary-author.resource.d.ts.map +1 -0
  18. package/dist/mcp-server/resources/definitions/openlibrary-author.resource.js +48 -0
  19. package/dist/mcp-server/resources/definitions/openlibrary-author.resource.js.map +1 -0
  20. package/dist/mcp-server/resources/definitions/openlibrary-work.resource.d.ts +21 -0
  21. package/dist/mcp-server/resources/definitions/openlibrary-work.resource.d.ts.map +1 -0
  22. package/dist/mcp-server/resources/definitions/openlibrary-work.resource.js +42 -0
  23. package/dist/mcp-server/resources/definitions/openlibrary-work.resource.js.map +1 -0
  24. package/dist/mcp-server/tools/definitions/openlibrary-get-author-works.tool.d.ts +26 -0
  25. package/dist/mcp-server/tools/definitions/openlibrary-get-author-works.tool.d.ts.map +1 -0
  26. package/dist/mcp-server/tools/definitions/openlibrary-get-author-works.tool.js +68 -0
  27. package/dist/mcp-server/tools/definitions/openlibrary-get-author-works.tool.js.map +1 -0
  28. package/dist/mcp-server/tools/definitions/openlibrary-get-author.tool.d.ts +31 -0
  29. package/dist/mcp-server/tools/definitions/openlibrary-get-author.tool.d.ts.map +1 -0
  30. package/dist/mcp-server/tools/definitions/openlibrary-get-author.tool.js +86 -0
  31. package/dist/mcp-server/tools/definitions/openlibrary-get-author.tool.js.map +1 -0
  32. package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.d.ts +26 -0
  33. package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.d.ts.map +1 -0
  34. package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.js +56 -0
  35. package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.js.map +1 -0
  36. package/dist/mcp-server/tools/definitions/openlibrary-get-edition.tool.d.ts +45 -0
  37. package/dist/mcp-server/tools/definitions/openlibrary-get-edition.tool.d.ts.map +1 -0
  38. package/dist/mcp-server/tools/definitions/openlibrary-get-edition.tool.js +132 -0
  39. package/dist/mcp-server/tools/definitions/openlibrary-get-edition.tool.js.map +1 -0
  40. package/dist/mcp-server/tools/definitions/openlibrary-get-editions.tool.d.ts +32 -0
  41. package/dist/mcp-server/tools/definitions/openlibrary-get-editions.tool.d.ts.map +1 -0
  42. package/dist/mcp-server/tools/definitions/openlibrary-get-editions.tool.js +106 -0
  43. package/dist/mcp-server/tools/definitions/openlibrary-get-editions.tool.js.map +1 -0
  44. package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.d.ts +29 -0
  45. package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.d.ts.map +1 -0
  46. package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.js +82 -0
  47. package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.js.map +1 -0
  48. package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.d.ts +27 -0
  49. package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.d.ts.map +1 -0
  50. package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.js +90 -0
  51. package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.js.map +1 -0
  52. package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.d.ts +31 -0
  53. package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.d.ts.map +1 -0
  54. package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.js +105 -0
  55. package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.js.map +1 -0
  56. package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.d.ts +65 -0
  57. package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.d.ts.map +1 -0
  58. package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.js +217 -0
  59. package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.js.map +1 -0
  60. package/dist/services/open-library/open-library-service.d.ts +57 -0
  61. package/dist/services/open-library/open-library-service.d.ts.map +1 -0
  62. package/dist/services/open-library/open-library-service.js +347 -0
  63. package/dist/services/open-library/open-library-service.js.map +1 -0
  64. package/dist/services/open-library/types.d.ts +129 -0
  65. package/dist/services/open-library/types.d.ts.map +1 -0
  66. package/dist/services/open-library/types.js +6 -0
  67. package/dist/services/open-library/types.js.map +1 -0
  68. package/package.json +79 -0
  69. package/server.json +99 -0
@@ -0,0 +1,119 @@
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
+ - -->
@@ -0,0 +1,11 @@
1
+ /**
2
+ * @fileoverview Server-specific configuration for openlibrary-mcp-server.
3
+ * @module config/server-config
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ declare const ServerConfigSchema: z.ZodObject<{
7
+ userAgent: z.ZodDefault<z.ZodString>;
8
+ }, z.core.$strip>;
9
+ export declare function getServerConfig(): z.infer<typeof ServerConfigSchema>;
10
+ export {};
11
+ //# sourceMappingURL=server-config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;iBAOtB,CAAC;AAIH,wBAAgB,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAKpE"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * @fileoverview Server-specific configuration for openlibrary-mcp-server.
3
+ * @module config/server-config
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
7
+ const ServerConfigSchema = z.object({
8
+ userAgent: z
9
+ .string()
10
+ .default('openlibrary-mcp-server/1.0 (openlibrary@archive.org)')
11
+ .describe('User-Agent header sent with all Open Library API requests. Include a contact email per community convention for well-behaved bots.'),
12
+ });
13
+ let _config;
14
+ export function getServerConfig() {
15
+ _config ??= parseEnvConfig(ServerConfigSchema, {
16
+ userAgent: 'OPENLIBRARY_USER_AGENT',
17
+ });
18
+ return _config;
19
+ }
20
+ //# sourceMappingURL=server-config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,OAAO,CAAC,sDAAsD,CAAC;SAC/D,QAAQ,CACP,oIAAoI,CACrI;CACJ,CAAC,CAAC;AAEH,IAAI,OAAuD,CAAC;AAE5D,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,SAAS,EAAE,wBAAwB;KACpC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,7 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * @fileoverview openlibrary-mcp-server MCP server entry point.
4
+ * @module index
5
+ */
6
+ export {};
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}
package/dist/index.js ADDED
@@ -0,0 +1,38 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * @fileoverview openlibrary-mcp-server MCP server entry point.
4
+ * @module index
5
+ */
6
+ import { createApp } from '@cyanheads/mcp-ts-core';
7
+ import { openlibraryAuthorResource } from './mcp-server/resources/definitions/openlibrary-author.resource.js';
8
+ import { openlibraryWorkResource } from './mcp-server/resources/definitions/openlibrary-work.resource.js';
9
+ import { openlibraryGetAuthor } from './mcp-server/tools/definitions/openlibrary-get-author.tool.js';
10
+ import { openlibraryGetAuthorWorks } from './mcp-server/tools/definitions/openlibrary-get-author-works.tool.js';
11
+ import { openlibraryGetCoverUrl } from './mcp-server/tools/definitions/openlibrary-get-cover-url.tool.js';
12
+ import { openlibraryGetEdition } from './mcp-server/tools/definitions/openlibrary-get-edition.tool.js';
13
+ import { openlibraryGetEditions } from './mcp-server/tools/definitions/openlibrary-get-editions.tool.js';
14
+ import { openlibraryGetSubject } from './mcp-server/tools/definitions/openlibrary-get-subject.tool.js';
15
+ import { openlibraryGetWork } from './mcp-server/tools/definitions/openlibrary-get-work.tool.js';
16
+ import { openlibrarySearchAuthors } from './mcp-server/tools/definitions/openlibrary-search-authors.tool.js';
17
+ import { openlibrarySearchBooks } from './mcp-server/tools/definitions/openlibrary-search-books.tool.js';
18
+ import { initOpenLibraryService } from './services/open-library/open-library-service.js';
19
+ await createApp({
20
+ tools: [
21
+ openlibrarySearchBooks,
22
+ openlibraryGetWork,
23
+ openlibraryGetEditions,
24
+ openlibraryGetEdition,
25
+ openlibrarySearchAuthors,
26
+ openlibraryGetAuthor,
27
+ openlibraryGetAuthorWorks,
28
+ openlibraryGetSubject,
29
+ openlibraryGetCoverUrl,
30
+ ],
31
+ resources: [openlibraryWorkResource, openlibraryAuthorResource],
32
+ prompts: [],
33
+ setup(core) {
34
+ void core;
35
+ initOpenLibraryService();
36
+ },
37
+ });
38
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mEAAmE,CAAC;AAC9G,OAAO,EAAE,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,yBAAyB,EAAE,MAAM,qEAAqE,CAAC;AAChH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC1G,OAAO,EAAE,qBAAqB,EAAE,MAAM,gEAAgE,CAAC;AACvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,iEAAiE,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAE,MAAM,gEAAgE,CAAC;AACvG,OAAO,EAAE,kBAAkB,EAAE,MAAM,6DAA6D,CAAC;AACjG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mEAAmE,CAAC;AAC7G,OAAO,EAAE,sBAAsB,EAAE,MAAM,iEAAiE,CAAC;AACzG,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAEzF,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,sBAAsB;QACtB,kBAAkB;QAClB,sBAAsB;QACtB,qBAAqB;QACrB,wBAAwB;QACxB,oBAAoB;QACpB,yBAAyB;QACzB,qBAAqB;QACrB,sBAAsB;KACvB;IACD,SAAS,EAAE,CAAC,uBAAuB,EAAE,yBAAyB,CAAC;IAC/D,OAAO,EAAE,EAAE;IACX,KAAK,CAAC,IAAI;QACR,KAAK,IAAI,CAAC;QACV,sBAAsB,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC,CAAC"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * @fileoverview Author detail resource — injectable context for chat about a specific author.
3
+ * @module mcp-server/resources/definitions/openlibrary-author.resource
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ export declare const openlibraryAuthorResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
7
+ author_id: z.ZodString;
8
+ }, z.core.$strip>, z.ZodObject<{
9
+ author_id: z.ZodString;
10
+ name: z.ZodString;
11
+ personal_name: z.ZodOptional<z.ZodString>;
12
+ fuller_name: z.ZodOptional<z.ZodString>;
13
+ bio: z.ZodOptional<z.ZodString>;
14
+ birth_date: z.ZodOptional<z.ZodString>;
15
+ death_date: z.ZodOptional<z.ZodString>;
16
+ photo_ids: z.ZodArray<z.ZodNumber>;
17
+ remote_ids: z.ZodObject<{
18
+ wikidata: z.ZodOptional<z.ZodString>;
19
+ viaf: z.ZodOptional<z.ZodString>;
20
+ isni: z.ZodOptional<z.ZodString>;
21
+ goodreads: z.ZodOptional<z.ZodString>;
22
+ librarything: z.ZodOptional<z.ZodString>;
23
+ }, z.core.$strip>;
24
+ }, z.core.$strip>, undefined>;
25
+ //# sourceMappingURL=openlibrary-author.resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openlibrary-author.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/openlibrary-author.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;6BAwCpC,CAAC"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * @fileoverview Author detail resource — injectable context for chat about a specific author.
3
+ * @module mcp-server/resources/definitions/openlibrary-author.resource
4
+ */
5
+ import { resource, z } from '@cyanheads/mcp-ts-core';
6
+ import { notFound } from '@cyanheads/mcp-ts-core/errors';
7
+ import { getOpenLibraryService } from '../../../services/open-library/open-library-service.js';
8
+ export const openlibraryAuthorResource = resource('openlibrary://authors/{author_id}', {
9
+ name: 'openlibrary-author',
10
+ title: 'Open Library Author',
11
+ description: 'Author detail by Open Library Author ID (OL…A). Provides name, bio, dates, photo IDs, and linked external identifiers as injectable context for a conversation about a specific author.',
12
+ mimeType: 'application/json',
13
+ params: z.object({
14
+ author_id: z.string().describe('Open Library Author ID (e.g., OL24638A).'),
15
+ }),
16
+ output: z.object({
17
+ author_id: z.string().describe('Open Library Author ID.'),
18
+ name: z.string().describe('Primary author name.'),
19
+ personal_name: z.string().optional().describe('Personal or given name.'),
20
+ fuller_name: z.string().optional().describe('Full name including middle names.'),
21
+ bio: z.string().optional().describe('Author biography. Absent when not provided.'),
22
+ birth_date: z.string().optional().describe('Birth date string.'),
23
+ death_date: z.string().optional().describe('Death date string.'),
24
+ photo_ids: z.array(z.number()).describe('Numeric photo IDs for openlibrary_get_cover_url.'),
25
+ remote_ids: z
26
+ .object({
27
+ wikidata: z.string().optional().describe('Wikidata entity ID.'),
28
+ viaf: z.string().optional().describe('VIAF identifier.'),
29
+ isni: z.string().optional().describe('ISNI identifier.'),
30
+ goodreads: z.string().optional().describe('Goodreads author ID.'),
31
+ librarything: z.string().optional().describe('LibraryThing author identifier.'),
32
+ })
33
+ .describe('External identifiers for cross-referencing.'),
34
+ }),
35
+ async handler(params, ctx) {
36
+ ctx.log.info('Fetching author resource', { author_id: params.author_id });
37
+ const svc = getOpenLibraryService();
38
+ try {
39
+ return await svc.getAuthor(params.author_id, ctx);
40
+ }
41
+ catch {
42
+ throw notFound(`Author ${params.author_id} not found on Open Library.`, {
43
+ author_id: params.author_id,
44
+ });
45
+ }
46
+ },
47
+ });
48
+ //# sourceMappingURL=openlibrary-author.resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openlibrary-author.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/openlibrary-author.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAExF,MAAM,CAAC,MAAM,yBAAyB,GAAG,QAAQ,CAAC,mCAAmC,EAAE;IACrF,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,yLAAyL;IAC3L,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;KAC3E,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACzD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACjD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACxE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAChF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAClF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAChE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAChE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC3F,UAAU,EAAE,CAAC;aACV,MAAM,CAAC;YACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAC/D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACxD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACjE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SAChF,CAAC;aACD,QAAQ,CAAC,6CAA6C,CAAC;KAC3D,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,QAAQ,CAAC,UAAU,MAAM,CAAC,SAAS,6BAA6B,EAAE;gBACtE,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * @fileoverview Work detail resource — injectable context for chat about a specific book.
3
+ * @module mcp-server/resources/definitions/openlibrary-work.resource
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ export declare const openlibraryWorkResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
7
+ work_id: z.ZodString;
8
+ }, z.core.$strip>, z.ZodObject<{
9
+ work_id: z.ZodString;
10
+ title: z.ZodString;
11
+ description: z.ZodOptional<z.ZodString>;
12
+ subjects: z.ZodArray<z.ZodString>;
13
+ subject_places: z.ZodArray<z.ZodString>;
14
+ subject_times: z.ZodArray<z.ZodString>;
15
+ subject_people: z.ZodArray<z.ZodString>;
16
+ cover_ids: z.ZodArray<z.ZodNumber>;
17
+ author_ids: z.ZodArray<z.ZodString>;
18
+ created: z.ZodOptional<z.ZodString>;
19
+ last_modified: z.ZodOptional<z.ZodString>;
20
+ }, z.core.$strip>, undefined>;
21
+ //# sourceMappingURL=openlibrary-work.resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openlibrary-work.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/openlibrary-work.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;6BAkClC,CAAC"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * @fileoverview Work detail resource — injectable context for chat about a specific book.
3
+ * @module mcp-server/resources/definitions/openlibrary-work.resource
4
+ */
5
+ import { resource, z } from '@cyanheads/mcp-ts-core';
6
+ import { notFound } from '@cyanheads/mcp-ts-core/errors';
7
+ import { getOpenLibraryService } from '../../../services/open-library/open-library-service.js';
8
+ export const openlibraryWorkResource = resource('openlibrary://works/{work_id}', {
9
+ name: 'openlibrary-work',
10
+ title: 'Open Library Work',
11
+ description: 'Work detail by Open Library Work ID (OL…W). Provides title, description, subjects, cover IDs, and author IDs as injectable context for a conversation about a specific book.',
12
+ mimeType: 'application/json',
13
+ params: z.object({
14
+ work_id: z.string().describe('Open Library Work ID (e.g., OL45804W).'),
15
+ }),
16
+ output: z.object({
17
+ work_id: z.string().describe('Open Library Work ID.'),
18
+ title: z.string().describe('Work title.'),
19
+ description: z.string().optional().describe('Work description. Absent when not provided.'),
20
+ subjects: z.array(z.string()).describe('Subject tags.'),
21
+ subject_places: z.array(z.string()).describe('Geographic subjects.'),
22
+ subject_times: z.array(z.string()).describe('Time period subjects.'),
23
+ subject_people: z.array(z.string()).describe('People subjects.'),
24
+ cover_ids: z.array(z.number()).describe('Numeric cover IDs for openlibrary_get_cover_url.'),
25
+ author_ids: z.array(z.string()).describe('Open Library Author IDs (OL…A).'),
26
+ created: z.string().optional().describe('ISO 8601 creation timestamp.'),
27
+ last_modified: z.string().optional().describe('ISO 8601 last-modified timestamp.'),
28
+ }),
29
+ async handler(params, ctx) {
30
+ ctx.log.info('Fetching work resource', { work_id: params.work_id });
31
+ const svc = getOpenLibraryService();
32
+ try {
33
+ return await svc.getWork(params.work_id, ctx);
34
+ }
35
+ catch {
36
+ throw notFound(`Work ${params.work_id} not found on Open Library.`, {
37
+ work_id: params.work_id,
38
+ });
39
+ }
40
+ },
41
+ });
42
+ //# sourceMappingURL=openlibrary-work.resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openlibrary-work.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/openlibrary-work.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAExF,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC,+BAA+B,EAAE;IAC/E,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACT,8KAA8K;IAChL,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KACvE,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC1F,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;QACvD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACpE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAChE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC3F,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACvE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KACnF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,QAAQ,CAAC,QAAQ,MAAM,CAAC,OAAO,6BAA6B,EAAE;gBAClE,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * @fileoverview List works by an author.
3
+ * @module mcp-server/tools/definitions/openlibrary-get-author-works.tool
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
7
+ export declare const openlibraryGetAuthorWorks: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
8
+ author_id: z.ZodString;
9
+ limit: z.ZodDefault<z.ZodNumber>;
10
+ offset: z.ZodDefault<z.ZodNumber>;
11
+ }, z.core.$strip>, z.ZodObject<{
12
+ total: z.ZodNumber;
13
+ author_id: z.ZodString;
14
+ works: z.ZodArray<z.ZodObject<{
15
+ work_id: z.ZodString;
16
+ title: z.ZodString;
17
+ first_publish_date: z.ZodOptional<z.ZodString>;
18
+ cover_ids: z.ZodArray<z.ZodNumber>;
19
+ }, z.core.$strip>>;
20
+ }, z.core.$strip>, readonly [{
21
+ readonly reason: "not_found";
22
+ readonly code: JsonRpcErrorCode.NotFound;
23
+ readonly when: "Author ID does not exist on Open Library.";
24
+ readonly recovery: "Verify the OLID format (e.g., \"OL24638A\") or use openlibrary_search_authors to find the correct ID.";
25
+ }]>;
26
+ //# sourceMappingURL=openlibrary-get-author-works.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openlibrary-get-author-works.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openlibrary-get-author-works.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;GAuEpC,CAAC"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * @fileoverview List works by an author.
3
+ * @module mcp-server/tools/definitions/openlibrary-get-author-works.tool
4
+ */
5
+ import { tool, z } from '@cyanheads/mcp-ts-core';
6
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
7
+ import { getOpenLibraryService } from '../../../services/open-library/open-library-service.js';
8
+ export const openlibraryGetAuthorWorks = tool('openlibrary_get_author_works', {
9
+ title: 'Get Author Works',
10
+ description: 'List works by an author. Returns titles, cover IDs, and work OLIDs for drilling into editions or details. Use openlibrary_get_author for author bio and details, or openlibrary_get_editions to explore specific printings.',
11
+ annotations: { readOnlyHint: true, openWorldHint: true },
12
+ input: z.object({
13
+ author_id: z
14
+ .string()
15
+ .describe('Open Library Author ID (OL…A). A leading "/authors/" prefix is stripped if provided.'),
16
+ limit: z.number().int().min(1).max(100).default(20).describe('Max works to return.'),
17
+ offset: z.number().int().min(0).default(0).describe('Zero-based offset for pagination.'),
18
+ }),
19
+ output: z.object({
20
+ total: z.number().describe('Total works by this author.'),
21
+ author_id: z.string().describe('Open Library Author ID.'),
22
+ works: z
23
+ .array(z
24
+ .object({
25
+ work_id: z
26
+ .string()
27
+ .describe('Open Library Work ID (OL…W). Use for openlibrary_get_work or openlibrary_get_editions.'),
28
+ title: z.string().describe('Work title.'),
29
+ first_publish_date: z
30
+ .string()
31
+ .optional()
32
+ .describe('First publication date string. Absent when not recorded.'),
33
+ cover_ids: z
34
+ .array(z.number())
35
+ .describe('Numeric cover IDs for openlibrary_get_cover_url.'),
36
+ })
37
+ .describe('A work by this author.'))
38
+ .describe('Works by this author, up to limit.'),
39
+ }),
40
+ errors: [
41
+ {
42
+ reason: 'not_found',
43
+ code: JsonRpcErrorCode.NotFound,
44
+ when: 'Author ID does not exist on Open Library.',
45
+ recovery: 'Verify the OLID format (e.g., "OL24638A") or use openlibrary_search_authors to find the correct ID.',
46
+ },
47
+ ],
48
+ handler(input, ctx) {
49
+ ctx.log.info('Fetching author works', { author_id: input.author_id, limit: input.limit });
50
+ const svc = getOpenLibraryService();
51
+ return svc.getAuthorWorks(input.author_id, input.limit, input.offset, ctx);
52
+ },
53
+ format: (result) => {
54
+ const lines = [];
55
+ lines.push(`**Author ID:** ${result.author_id} | **Total works:** ${result.total} | **Returned:** ${result.works.length}`);
56
+ for (const work of result.works) {
57
+ lines.push('');
58
+ lines.push(`### ${work.title}`);
59
+ lines.push(`**Work ID:** ${work.work_id}`);
60
+ if (work.first_publish_date)
61
+ lines.push(`**First published:** ${work.first_publish_date}`);
62
+ if (work.cover_ids.length)
63
+ lines.push(`**Cover IDs:** ${work.cover_ids.join(', ')}`);
64
+ }
65
+ return [{ type: 'text', text: lines.join('\n') }];
66
+ },
67
+ });
68
+ //# sourceMappingURL=openlibrary-get-author-works.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openlibrary-get-author-works.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openlibrary-get-author-works.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * @fileoverview Fetch author detail by Open Library Author ID.
3
+ * @module mcp-server/tools/definitions/openlibrary-get-author.tool
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
7
+ export declare const openlibraryGetAuthor: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
8
+ author_id: z.ZodString;
9
+ }, z.core.$strip>, z.ZodObject<{
10
+ author_id: z.ZodString;
11
+ name: z.ZodString;
12
+ personal_name: z.ZodOptional<z.ZodString>;
13
+ fuller_name: z.ZodOptional<z.ZodString>;
14
+ bio: z.ZodOptional<z.ZodString>;
15
+ birth_date: z.ZodOptional<z.ZodString>;
16
+ death_date: z.ZodOptional<z.ZodString>;
17
+ photo_ids: z.ZodArray<z.ZodNumber>;
18
+ remote_ids: z.ZodObject<{
19
+ wikidata: z.ZodOptional<z.ZodString>;
20
+ viaf: z.ZodOptional<z.ZodString>;
21
+ isni: z.ZodOptional<z.ZodString>;
22
+ goodreads: z.ZodOptional<z.ZodString>;
23
+ librarything: z.ZodOptional<z.ZodString>;
24
+ }, z.core.$strip>;
25
+ }, z.core.$strip>, readonly [{
26
+ readonly reason: "not_found";
27
+ readonly code: JsonRpcErrorCode.NotFound;
28
+ readonly when: "Author ID does not exist on Open Library.";
29
+ readonly recovery: "Verify the OLID format (e.g., \"OL24638A\") or use openlibrary_search_authors to find the correct ID.";
30
+ }]>;
31
+ //# sourceMappingURL=openlibrary-get-author.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openlibrary-get-author.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openlibrary-get-author.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;GA8E/B,CAAC"}
@@ -0,0 +1,86 @@
1
+ /**
2
+ * @fileoverview Fetch author detail by Open Library Author ID.
3
+ * @module mcp-server/tools/definitions/openlibrary-get-author.tool
4
+ */
5
+ import { tool, z } from '@cyanheads/mcp-ts-core';
6
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
7
+ import { getOpenLibraryService } from '../../../services/open-library/open-library-service.js';
8
+ export const openlibraryGetAuthor = tool('openlibrary_get_author', {
9
+ title: 'Get Author',
10
+ description: 'Fetch author detail by Open Library Author ID (OL…A). Returns bio, birth/death dates, photo IDs, and linked identifiers from Wikidata, VIAF, ISNI, Goodreads, and LibraryThing. Use openlibrary_search_authors to find an author ID first.',
11
+ annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
12
+ input: z.object({
13
+ author_id: z
14
+ .string()
15
+ .describe('Open Library Author ID. Format: OL…A (e.g., "OL24638A"). A leading "/authors/" prefix is stripped if provided.'),
16
+ }),
17
+ output: z.object({
18
+ author_id: z.string().describe('Canonical Open Library Author ID (OL…A).'),
19
+ name: z.string().describe('Primary author name.'),
20
+ personal_name: z
21
+ .string()
22
+ .optional()
23
+ .describe('Personal or given name. Absent when not recorded.'),
24
+ fuller_name: z
25
+ .string()
26
+ .optional()
27
+ .describe('Full name including middle names. Absent when not recorded.'),
28
+ bio: z.string().optional().describe('Author biography. Absent when not provided.'),
29
+ birth_date: z.string().optional().describe('Birth date string. Absent when not recorded.'),
30
+ death_date: z.string().optional().describe('Death date string. Absent when not recorded.'),
31
+ photo_ids: z
32
+ .array(z.number())
33
+ .describe('Numeric photo IDs. Pass to openlibrary_get_cover_url with target "author" and id_type "id".'),
34
+ remote_ids: z
35
+ .object({
36
+ wikidata: z.string().optional().describe('Wikidata entity ID (e.g., Q12345).'),
37
+ viaf: z.string().optional().describe('VIAF identifier.'),
38
+ isni: z.string().optional().describe('ISNI identifier.'),
39
+ goodreads: z.string().optional().describe('Goodreads author ID.'),
40
+ librarything: z.string().optional().describe('LibraryThing author identifier.'),
41
+ })
42
+ .describe('Remote identifiers for cross-referencing with other databases.'),
43
+ }),
44
+ errors: [
45
+ {
46
+ reason: 'not_found',
47
+ code: JsonRpcErrorCode.NotFound,
48
+ when: 'Author ID does not exist on Open Library.',
49
+ recovery: 'Verify the OLID format (e.g., "OL24638A") or use openlibrary_search_authors to find the correct ID.',
50
+ },
51
+ ],
52
+ handler(input, ctx) {
53
+ ctx.log.info('Fetching author', { author_id: input.author_id });
54
+ const svc = getOpenLibraryService();
55
+ return svc.getAuthor(input.author_id, ctx);
56
+ },
57
+ format: (result) => {
58
+ const lines = [];
59
+ lines.push(`## ${result.name}`);
60
+ lines.push(`**Author ID:** ${result.author_id}`);
61
+ if (result.personal_name)
62
+ lines.push(`**Personal name:** ${result.personal_name}`);
63
+ if (result.fuller_name)
64
+ lines.push(`**Fuller name:** ${result.fuller_name}`);
65
+ const dates = [];
66
+ if (result.birth_date)
67
+ dates.push(`Born: ${result.birth_date}`);
68
+ if (result.death_date)
69
+ dates.push(`Died: ${result.death_date}`);
70
+ if (dates.length)
71
+ lines.push(dates.join(' | '));
72
+ if (result.bio) {
73
+ lines.push('');
74
+ lines.push(result.bio);
75
+ }
76
+ if (result.photo_ids.length)
77
+ lines.push(`**Photo IDs:** ${result.photo_ids.join(', ')}`);
78
+ const remoteIds = Object.entries(result.remote_ids)
79
+ .filter(([, v]) => v != null)
80
+ .map(([k, v]) => `${k}: ${v}`);
81
+ if (remoteIds.length)
82
+ lines.push(`**External IDs:** ${remoteIds.join(' | ')}`);
83
+ return [{ type: 'text', text: lines.join('\n') }];
84
+ },
85
+ });
86
+ //# sourceMappingURL=openlibrary-get-author.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openlibrary-get-author.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openlibrary-get-author.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAExF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,wBAAwB,EAAE;IACjE,KAAK,EAAE,YAAY;IACnB,WAAW,EACT,4OAA4O;IAC9O,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,CACP,gHAAgH,CACjH;KACJ,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QAC1E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACjD,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,mDAAmD,CAAC;QAChE,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,6DAA6D,CAAC;QAC1E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAClF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC1F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC1F,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,6FAA6F,CAC9F;QACH,UAAU,EAAE,CAAC;aACV,MAAM,CAAC;YACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC9E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACxD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACjE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SAChF,CAAC;aACD,QAAQ,CAAC,gEAAgE,CAAC;KAC9E,CAAC;IACF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,2CAA2C;YACjD,QAAQ,EACN,qGAAqG;SACxG;KACF;IAED,OAAO,CAAC,KAAK,EAAE,GAAG;QAChB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;QACnF,IAAI,MAAM,CAAC,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAChE,IAAI,MAAM,CAAC,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAChE,IAAI,KAAK,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;aAChD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,SAAS,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}