@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.
- package/CLAUDE.md +391 -0
- package/Dockerfile +98 -0
- package/LICENSE +201 -0
- package/README.md +316 -0
- package/changelog/0.1.x/0.1.0.md +22 -0
- package/changelog/0.1.x/0.1.1.md +25 -0
- package/changelog/template.md +119 -0
- package/dist/config/server-config.d.ts +11 -0
- package/dist/config/server-config.d.ts.map +1 -0
- package/dist/config/server-config.js +20 -0
- package/dist/config/server-config.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +38 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/openlibrary-author.resource.d.ts +25 -0
- package/dist/mcp-server/resources/definitions/openlibrary-author.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/openlibrary-author.resource.js +48 -0
- package/dist/mcp-server/resources/definitions/openlibrary-author.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/openlibrary-work.resource.d.ts +21 -0
- package/dist/mcp-server/resources/definitions/openlibrary-work.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/openlibrary-work.resource.js +42 -0
- package/dist/mcp-server/resources/definitions/openlibrary-work.resource.js.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-author-works.tool.d.ts +26 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-author-works.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-author-works.tool.js +68 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-author-works.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-author.tool.d.ts +31 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-author.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-author.tool.js +86 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-author.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.d.ts +26 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.js +56 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-edition.tool.d.ts +45 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-edition.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-edition.tool.js +132 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-edition.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-editions.tool.d.ts +32 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-editions.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-editions.tool.js +106 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-editions.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.d.ts +29 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.js +82 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.d.ts +27 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.js +90 -0
- package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.d.ts +31 -0
- package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.js +105 -0
- package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.d.ts +65 -0
- package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.js +217 -0
- package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.js.map +1 -0
- package/dist/services/open-library/open-library-service.d.ts +57 -0
- package/dist/services/open-library/open-library-service.d.ts.map +1 -0
- package/dist/services/open-library/open-library-service.js +347 -0
- package/dist/services/open-library/open-library-service.js.map +1 -0
- package/dist/services/open-library/types.d.ts +129 -0
- package/dist/services/open-library/types.d.ts.map +1 -0
- package/dist/services/open-library/types.js +6 -0
- package/dist/services/open-library/types.js.map +1 -0
- package/package.json +79 -0
- 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"}
|
package/dist/index.d.ts
ADDED
|
@@ -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":"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"}
|