@cyanheads/musicbrainz-mcp-server 0.1.9 → 0.2.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/AGENTS.md +33 -15
- package/CLAUDE.md +33 -15
- package/Dockerfile +3 -3
- package/README.md +40 -21
- package/changelog/0.2.x/0.2.0.md +28 -0
- package/changelog/0.2.x/0.2.1.md +32 -0
- package/dist/config/server-config.d.ts +1 -0
- package/dist/config/server-config.d.ts.map +1 -1
- package/dist/config/server-config.js +5 -0
- package/dist/config/server-config.js.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/entity.resource.js +14 -4
- package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
- package/dist/mcp-server/tools/definitions/_pagination.d.ts +12 -0
- package/dist/mcp-server/tools/definitions/_pagination.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/_pagination.js +46 -0
- package/dist/mcp-server/tools/definitions/_pagination.js.map +1 -0
- package/dist/mcp-server/tools/definitions/_shared.d.ts +10 -4
- package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/_shared.js +44 -27
- package/dist/mcp-server/tools/definitions/_shared.js.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +10 -7
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js +83 -50
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +5 -3
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-artist.tool.js +6 -6
- package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +12 -5
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +66 -24
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-label.tool.js +3 -3
- package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +14 -1
- package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recording.tool.js +26 -5
- package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release-group.tool.js +3 -3
- package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +14 -4
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release.tool.js +50 -8
- package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +12 -4
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.js +33 -10
- package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +62 -16
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +2 -2
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +26 -7
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +3 -1
- package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-entities.tool.js +23 -18
- package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
- package/dist/services/cover-art/cover-art-service.d.ts +2 -2
- package/dist/services/cover-art/cover-art-service.d.ts.map +1 -1
- package/dist/services/cover-art/cover-art-service.js +6 -7
- package/dist/services/cover-art/cover-art-service.js.map +1 -1
- package/dist/services/musicbrainz/mbid.d.ts +5 -0
- package/dist/services/musicbrainz/mbid.d.ts.map +1 -0
- package/dist/services/musicbrainz/mbid.js +17 -0
- package/dist/services/musicbrainz/mbid.js.map +1 -0
- package/dist/services/musicbrainz/musicbrainz-service.d.ts +8 -3
- package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
- package/dist/services/musicbrainz/musicbrainz-service.js +27 -8
- package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
- package/dist/services/musicbrainz/release-appearances.d.ts +16 -0
- package/dist/services/musicbrainz/release-appearances.d.ts.map +1 -0
- package/dist/services/musicbrainz/release-appearances.js +15 -0
- package/dist/services/musicbrainz/release-appearances.js.map +1 -0
- package/dist/services/musicbrainz/types.d.ts +7 -4
- package/dist/services/musicbrainz/types.d.ts.map +1 -1
- package/dist/services/musicbrainz/work-relations.d.ts +19 -0
- package/dist/services/musicbrainz/work-relations.d.ts.map +1 -0
- package/dist/services/musicbrainz/work-relations.js +26 -0
- package/dist/services/musicbrainz/work-relations.js.map +1 -0
- package/package.json +8 -8
- package/server.json +17 -3
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
* @fileoverview musicbrainz_get_cover_art — Cover Art Archive images for a release
|
|
3
3
|
* or release-group MBID: front/back flags, image types, full-resolution URLs, and
|
|
4
4
|
* 250/500/1200px thumbnails. Returns an empty image set (not an error) when the
|
|
5
|
-
* entity has no art.
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
5
|
+
* entity has no art. Malformed/all-zero MBIDs fail before fetch. For a well-shaped
|
|
6
|
+
* MBID an archive 404 means no art or no entity, so the handler checks it with a
|
|
7
|
+
* bounded MusicBrainz lookup of the same entity type before reporting "no art".
|
|
8
|
+
* Separate from musicbrainz_get_release so art is
|
|
9
9
|
* fetchable without the full record.
|
|
10
10
|
* @module mcp-server/tools/definitions/get-cover-art.tool
|
|
11
11
|
*/
|
|
@@ -13,7 +13,7 @@ import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
|
13
13
|
import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
|
|
14
14
|
import { getCoverArtService } from '../../../services/cover-art/cover-art-service.js';
|
|
15
15
|
import { getMusicBrainzService } from '../../../services/musicbrainz/musicbrainz-service.js';
|
|
16
|
-
import { classifyMbidError, MBID_EXAMPLE, safeText } from './_shared.js';
|
|
16
|
+
import { classifyMbidError, MBID_EXAMPLE, MbidInput, safeText, safeUrl } from './_shared.js';
|
|
17
17
|
/**
|
|
18
18
|
* Bounds on the MBID check made after a Cover Art Archive 404: one attempt, a
|
|
19
19
|
* short timeout. It only decides between "no art" and an MBID error, so a slow
|
|
@@ -47,13 +47,13 @@ const ImageSchema = z
|
|
|
47
47
|
.describe('One cover-art image with its full URL and thumbnails.');
|
|
48
48
|
export const getCoverArtTool = tool('musicbrainz_get_cover_art', {
|
|
49
49
|
title: 'musicbrainz-mcp-server: get cover art',
|
|
50
|
-
description: "Cover Art Archive images for a release or release-group MBID: front/back flags, image types, full-resolution URLs, and 250/500/1200px thumbnail URLs.
|
|
50
|
+
description: "Cover Art Archive images for a release or release-group MBID: front/back flags, image types, full-resolution URLs, and 250/500/1200px thumbnail URLs. limit defaults to 25 and clamps above 100; offset defaults to 0. Pages retain archive order, totalCount counts all images, and hasArt describes the full archive even on an empty page. Follow the notice for the next offset. No art is a successful empty result; an unknown MBID fails with entity_not_found after a bounded MusicBrainz check. A release-group resolves to a representative release's art. URLs are linked, never rehosted; image copyright stays with rights holders.",
|
|
51
51
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
|
|
52
52
|
errors: [
|
|
53
53
|
{
|
|
54
54
|
reason: 'invalid_mbid',
|
|
55
55
|
code: JsonRpcErrorCode.ValidationError,
|
|
56
|
-
when: 'The MBID is malformed or the all-zeros sentinel
|
|
56
|
+
when: 'The MBID is malformed or the all-zeros sentinel (rejected before fetch), or an upstream rejects it with HTTP 400.',
|
|
57
57
|
recovery: `MBID must be a 36-character UUID (e.g. ${MBID_EXAMPLE}). Use musicbrainz_search_entities to find a release or release-group MBID.`,
|
|
58
58
|
},
|
|
59
59
|
{
|
|
@@ -64,27 +64,46 @@ export const getCoverArtTool = tool('musicbrainz_get_cover_art', {
|
|
|
64
64
|
},
|
|
65
65
|
],
|
|
66
66
|
input: z.object({
|
|
67
|
-
mbid:
|
|
67
|
+
mbid: MbidInput.describe('Release or release-group MBID (hyphenated hexadecimal UUID; surrounding whitespace and uppercase accepted).'),
|
|
68
68
|
entity_type: z
|
|
69
69
|
.enum(['release', 'release-group'])
|
|
70
70
|
.default('release')
|
|
71
71
|
.describe('Whether the MBID is a release (default) or a release-group.'),
|
|
72
|
+
limit: z
|
|
73
|
+
.number()
|
|
74
|
+
.int()
|
|
75
|
+
.min(1)
|
|
76
|
+
.default(25)
|
|
77
|
+
.describe('Maximum images returned (default 25; values above 100 clamp to 100 with a notice).'),
|
|
78
|
+
offset: z
|
|
79
|
+
.number()
|
|
80
|
+
.int()
|
|
81
|
+
.min(0)
|
|
82
|
+
.default(0)
|
|
83
|
+
.describe('Zero-based image offset in archive order (default 0).'),
|
|
72
84
|
}),
|
|
73
85
|
output: z.object({
|
|
74
86
|
mbid: z.string().describe('The MBID that was queried.'),
|
|
75
87
|
entityType: z.string().describe('Whether the MBID was treated as a release or release-group.'),
|
|
88
|
+
offset: z.number().describe('Effective zero-based image offset in archive order.'),
|
|
76
89
|
representativeRelease: z
|
|
77
90
|
.string()
|
|
78
91
|
.optional()
|
|
79
92
|
.describe('For a release-group query, the release MBID whose art was returned. Omitted for direct release queries.'),
|
|
80
|
-
images: z
|
|
93
|
+
images: z
|
|
94
|
+
.array(ImageSchema)
|
|
95
|
+
.describe('Selected cover-art images in archive order (empty for no art or an exhausted page).'),
|
|
81
96
|
}),
|
|
82
97
|
enrichment: {
|
|
83
98
|
hasArt: z.boolean().describe('Whether any cover art exists for this entity.'),
|
|
99
|
+
totalCount: z.number().describe('Exact image total before the limit and offset window.'),
|
|
100
|
+
truncated: z.boolean().optional().describe('True when images remain after this nonempty page.'),
|
|
101
|
+
shown: z.number().optional().describe('Images returned when more remain.'),
|
|
102
|
+
cap: z.number().optional().describe('Applied image limit when more remain.'),
|
|
84
103
|
notice: z
|
|
85
104
|
.string()
|
|
86
105
|
.optional()
|
|
87
|
-
.describe('
|
|
106
|
+
.describe('Combined limit clamp, continuation, exhausted page, or no-art/existence-unconfirmed guidance.'),
|
|
88
107
|
},
|
|
89
108
|
async handler(input, ctx) {
|
|
90
109
|
ctx.log.info('musicbrainz_get_cover_art', { mbid: input.mbid, entityType: input.entity_type });
|
|
@@ -95,15 +114,19 @@ export const getCoverArtTool = tool('musicbrainz_get_cover_art', {
|
|
|
95
114
|
});
|
|
96
115
|
}
|
|
97
116
|
catch (error) {
|
|
98
|
-
|
|
99
|
-
|
|
117
|
+
/**
|
|
118
|
+
* The service maps 404 to `found: false`; local MBID rejection and
|
|
119
|
+
* upstream 400 both surface as ValidationError.
|
|
120
|
+
*/
|
|
100
121
|
if (error instanceof McpError && error.code === JsonRpcErrorCode.ValidationError) {
|
|
101
122
|
throw ctx.fail('invalid_mbid', undefined, { mbid: input.mbid });
|
|
102
123
|
}
|
|
103
124
|
throw error;
|
|
104
125
|
}
|
|
105
|
-
|
|
106
|
-
|
|
126
|
+
/**
|
|
127
|
+
* A CAA 404 cannot tell "no art" from "no such entity" — MusicBrainz
|
|
128
|
+
* answers 404 for an unknown MBID and 200 for an existing entity.
|
|
129
|
+
*/
|
|
107
130
|
let existenceConfirmed = true;
|
|
108
131
|
if (!raw.found) {
|
|
109
132
|
try {
|
|
@@ -113,6 +136,7 @@ export const getCoverArtTool = tool('musicbrainz_get_cover_art', {
|
|
|
113
136
|
});
|
|
114
137
|
}
|
|
115
138
|
catch (error) {
|
|
139
|
+
ctx.signal.throwIfAborted();
|
|
116
140
|
const reason = classifyMbidError(error);
|
|
117
141
|
if (reason === 'invalid_mbid')
|
|
118
142
|
throw ctx.fail('invalid_mbid', undefined, { mbid: input.mbid });
|
|
@@ -130,7 +154,9 @@ export const getCoverArtTool = tool('musicbrainz_get_cover_art', {
|
|
|
130
154
|
existenceConfirmed = false;
|
|
131
155
|
}
|
|
132
156
|
}
|
|
133
|
-
const
|
|
157
|
+
const totalCount = raw.images?.length ?? 0;
|
|
158
|
+
const limit = Math.min(input.limit, 100);
|
|
159
|
+
const images = (raw.images ?? []).slice(input.offset, input.offset + limit).map((img) => ({
|
|
134
160
|
id: String(img.id ?? ''),
|
|
135
161
|
front: img.front === true,
|
|
136
162
|
back: img.back === true,
|
|
@@ -142,18 +168,33 @@ export const getCoverArtTool = tool('musicbrainz_get_cover_art', {
|
|
|
142
168
|
...(typeof img.approved === 'boolean' ? { approved: img.approved } : {}),
|
|
143
169
|
...(img.comment ? { comment: img.comment } : {}),
|
|
144
170
|
}));
|
|
145
|
-
ctx.enrich({ hasArt:
|
|
146
|
-
|
|
147
|
-
|
|
171
|
+
ctx.enrich({ hasArt: totalCount > 0 });
|
|
172
|
+
ctx.enrich.total(totalCount);
|
|
173
|
+
const notices = [];
|
|
174
|
+
if (input.limit > limit)
|
|
175
|
+
notices.push(`Requested limit=${input.limit}; applied limit=${limit} (maximum 100).`);
|
|
176
|
+
const nextOffset = input.offset + images.length;
|
|
177
|
+
if (images.length > 0 && nextOffset < totalCount) {
|
|
178
|
+
ctx.enrich({ truncated: true, shown: images.length, cap: limit });
|
|
179
|
+
notices.push(`Showing ${images.length} of ${totalCount} images at offset=${input.offset}. Continue with musicbrainz_get_cover_art (mbid=${input.mbid}, entity_type=${input.entity_type}, limit=${limit}, offset=${nextOffset}).`);
|
|
180
|
+
}
|
|
181
|
+
else if (totalCount > 0 && images.length === 0) {
|
|
182
|
+
notices.push(`Image page exhausted at offset=${input.offset}; ${totalCount} images exist for this entity.`);
|
|
183
|
+
}
|
|
184
|
+
else if (totalCount === 0) {
|
|
185
|
+
notices.push(existenceConfirmed
|
|
148
186
|
? `No cover art exists for ${input.entity_type} ${input.mbid}. This is not an error — the Cover Art Archive simply has no images for it.`
|
|
149
187
|
: `The Cover Art Archive has no images for ${input.entity_type} ${input.mbid}, but whether that MBID exists in MusicBrainz could not be confirmed (the check failed upstream). If the MBID may be wrong, verify it with musicbrainz_search_entities.`);
|
|
150
188
|
}
|
|
189
|
+
if (notices.length)
|
|
190
|
+
ctx.enrich.notice(notices.join(' '));
|
|
151
191
|
// The representative release MBID is the trailing path segment of the `release`
|
|
152
192
|
// URL the CAA returns (present on release-group lookups after the 307 redirect).
|
|
153
193
|
const representativeRelease = raw.release?.split('/').filter(Boolean).pop();
|
|
154
194
|
return {
|
|
155
|
-
mbid: input.mbid,
|
|
195
|
+
mbid: input.mbid.trim().toLowerCase(),
|
|
156
196
|
entityType: input.entity_type,
|
|
197
|
+
offset: input.offset,
|
|
157
198
|
...(input.entity_type === 'release-group' && representativeRelease
|
|
158
199
|
? { representativeRelease }
|
|
159
200
|
: {}),
|
|
@@ -164,8 +205,9 @@ export const getCoverArtTool = tool('musicbrainz_get_cover_art', {
|
|
|
164
205
|
const lines = [`## Cover art: ${result.entityType} ${result.mbid}`];
|
|
165
206
|
if (result.representativeRelease)
|
|
166
207
|
lines.push(`**Representative release:** ${result.representativeRelease}`);
|
|
208
|
+
lines.push(`**Image window:** offset: ${result.offset}, shown: ${result.images.length}`);
|
|
167
209
|
if (result.images.length === 0) {
|
|
168
|
-
lines.push('', '_No cover art available
|
|
210
|
+
lines.push('', '_No cover art available in this image page; the page is empty._');
|
|
169
211
|
}
|
|
170
212
|
else {
|
|
171
213
|
lines.push(`**Images:** ${result.images.length}`);
|
|
@@ -178,13 +220,13 @@ export const getCoverArtTool = tool('musicbrainz_get_cover_art', {
|
|
|
178
220
|
.filter(Boolean)
|
|
179
221
|
.join(', ');
|
|
180
222
|
lines.push(`\n### Image ${safeText(img.id)}${flags ? ` (${flags})` : ''}`);
|
|
181
|
-
lines.push(`**Full:** ${
|
|
223
|
+
lines.push(`**Full:** ${safeUrl(img.imageUrl)}`);
|
|
182
224
|
if (img.thumbnail250)
|
|
183
|
-
lines.push(`**250px:** ${
|
|
225
|
+
lines.push(`**250px:** ${safeUrl(img.thumbnail250)}`);
|
|
184
226
|
if (img.thumbnail500)
|
|
185
|
-
lines.push(`**500px:** ${
|
|
227
|
+
lines.push(`**500px:** ${safeUrl(img.thumbnail500)}`);
|
|
186
228
|
if (img.thumbnail1200)
|
|
187
|
-
lines.push(`**1200px:** ${
|
|
229
|
+
lines.push(`**1200px:** ${safeUrl(img.thumbnail1200)}`);
|
|
188
230
|
if (typeof img.approved === 'boolean')
|
|
189
231
|
lines.push(`**Approved:** ${img.approved ? 'yes' : 'no'}`);
|
|
190
232
|
if (img.comment)
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-cover-art.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-cover-art.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAuB,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AACpG,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"get-cover-art.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-cover-art.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -41,7 +41,7 @@ export declare const getLabelTool: import("@cyanheads/mcp-ts-core").ToolDefiniti
|
|
|
41
41
|
}, z.core.$strip>, readonly [{
|
|
42
42
|
readonly reason: "invalid_mbid";
|
|
43
43
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
44
|
-
readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz
|
|
44
|
+
readonly when: "The MBID is malformed or the all-zeros sentinel (rejected before fetch), or MusicBrainz rejects it with HTTP 400.";
|
|
45
45
|
readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entityType=label) to find one from a name.";
|
|
46
46
|
}, {
|
|
47
47
|
readonly reason: "entity_not_found";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-label.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-label.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"get-label.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-label.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsBjE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8GvB,CAAC"}
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
9
9
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
10
10
|
import { getMusicBrainzService } from '../../../services/musicbrainz/musicbrainz-service.js';
|
|
11
|
-
import { AliasSchema, classifyMbidError, ExternalLinkSchema, LifeSpanSchema, MBID_EXAMPLE, normalizeAliases, normalizeLifeSpan, normalizeRelations, normalizeTags, renderAliases, renderExternalLinks, renderLifeSpan, renderTags, safeText, TagSchema, } from './_shared.js';
|
|
11
|
+
import { AliasSchema, classifyMbidError, ExternalLinkSchema, LifeSpanSchema, MBID_EXAMPLE, MbidInput, normalizeAliases, normalizeLifeSpan, normalizeRelations, normalizeTags, renderAliases, renderExternalLinks, renderLifeSpan, renderTags, safeText, TagSchema, } from './_shared.js';
|
|
12
12
|
export const getLabelTool = tool('musicbrainz_get_label', {
|
|
13
13
|
title: 'musicbrainz-mcp-server: get label',
|
|
14
14
|
description: "Label by MBID: type (Original Production, Reissue, Imprint, …), country, life span, label code (the LC number), area, aliases, tags, and external links (url-rels — Wikidata, Discogs, official site). A label's releases are a potentially huge linked set (a major label can have tens of thousands), so they are NOT embedded here — enumerate them with musicbrainz_browse_entities (target_type=release, link.label).",
|
|
@@ -17,7 +17,7 @@ export const getLabelTool = tool('musicbrainz_get_label', {
|
|
|
17
17
|
{
|
|
18
18
|
reason: 'invalid_mbid',
|
|
19
19
|
code: JsonRpcErrorCode.ValidationError,
|
|
20
|
-
when: 'The MBID is malformed or the all-zeros sentinel (MusicBrainz
|
|
20
|
+
when: 'The MBID is malformed or the all-zeros sentinel (rejected before fetch), or MusicBrainz rejects it with HTTP 400.',
|
|
21
21
|
recovery: `MBID must be a 36-character UUID (e.g. ${MBID_EXAMPLE}). Use musicbrainz_search_entities (entityType=label) to find one from a name.`,
|
|
22
22
|
},
|
|
23
23
|
{
|
|
@@ -28,7 +28,7 @@ export const getLabelTool = tool('musicbrainz_get_label', {
|
|
|
28
28
|
},
|
|
29
29
|
],
|
|
30
30
|
input: z.object({
|
|
31
|
-
mbid:
|
|
31
|
+
mbid: MbidInput.describe('Label MBID (hyphenated hexadecimal UUID; surrounding whitespace and uppercase accepted).'),
|
|
32
32
|
}),
|
|
33
33
|
output: z.object({
|
|
34
34
|
mbid: z.string().describe('Label MBID.'),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-label.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-label.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,+CAA+C,CAAC;AAEtF,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,EAAE;IACxD,KAAK,EAAE,mCAAmC;IAC1C,WAAW,EACT,4ZAA4Z;IAC9Z,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAE9E,MAAM,EAAE;QACN;YACE,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"get-label.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-label.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,+CAA+C,CAAC;AAEtF,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,EAAE;IACxD,KAAK,EAAE,mCAAmC;IAC1C,WAAW,EACT,4ZAA4Z;IAC9Z,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAE9E,MAAM,EAAE;QACN;YACE,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,mHAAmH;YACzH,QAAQ,EAAE,0CAA0C,YAAY,gFAAgF;SACjJ;QACD;YACE,MAAM,EAAE,kBAAkB;YAC1B,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,qFAAqF;YAC3F,QAAQ,EACN,oGAAoG;SACvG;KACF;IAED,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,SAAS,CAAC,QAAQ,CACtB,0FAA0F,CAC3F;KACF,CAAC;IAEF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QACpF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACvF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QACzE,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,uEAAuE,CAAC;QACpF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QAClF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACnF,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC1C,kDAAkD,CACnD;QACD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACzE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QAC1E,aAAa,EAAE,CAAC;aACb,KAAK,CAAC,kBAAkB,CAAC;aACzB,QAAQ,CAAC,oDAAoD,CAAC;KAClE,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;QAExC,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,CACxB,OAAO,EACP,KAAK,CAAC,IAAI,EACV,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,EAClD,GAAG,EACH,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,MAAM,KAAK,cAAc;gBAC3B,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,IAAI,MAAM,KAAK,kBAAkB;gBAC/B,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,EAAE,aAAa,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;QAErD,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,EAAE;YACZ,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;YACpB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;YACtC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC;YAC3C,aAAa;SACd,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG;YACZ,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;SACrG,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/F,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,IAAI,MAAM,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,MAAM,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/E,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}
|
|
@@ -30,6 +30,17 @@ export declare const getRecordingTool: import("@cyanheads/mcp-ts-core").ToolDefi
|
|
|
30
30
|
date: z.ZodOptional<z.ZodString>;
|
|
31
31
|
country: z.ZodOptional<z.ZodString>;
|
|
32
32
|
}, z.core.$strip>>;
|
|
33
|
+
releaseAppearanceSummary: z.ZodObject<{
|
|
34
|
+
shown: z.ZodNumber;
|
|
35
|
+
cap: z.ZodNumber;
|
|
36
|
+
completeness: z.ZodEnum<{
|
|
37
|
+
complete: "complete";
|
|
38
|
+
truncated: "truncated";
|
|
39
|
+
unknown: "unknown";
|
|
40
|
+
}>;
|
|
41
|
+
totalCount: z.ZodOptional<z.ZodNumber>;
|
|
42
|
+
notice: z.ZodString;
|
|
43
|
+
}, z.core.$strip>;
|
|
33
44
|
relationships: z.ZodArray<z.ZodObject<{
|
|
34
45
|
type: z.ZodString;
|
|
35
46
|
direction: z.ZodOptional<z.ZodString>;
|
|
@@ -37,6 +48,8 @@ export declare const getRecordingTool: import("@cyanheads/mcp-ts-core").ToolDefi
|
|
|
37
48
|
targetType: z.ZodString;
|
|
38
49
|
targetId: z.ZodOptional<z.ZodString>;
|
|
39
50
|
targetName: z.ZodOptional<z.ZodString>;
|
|
51
|
+
targetDisambiguation: z.ZodOptional<z.ZodString>;
|
|
52
|
+
orderingKey: z.ZodOptional<z.ZodNumber>;
|
|
40
53
|
begin: z.ZodOptional<z.ZodString>;
|
|
41
54
|
end: z.ZodOptional<z.ZodString>;
|
|
42
55
|
}, z.core.$strip>>;
|
|
@@ -47,7 +60,7 @@ export declare const getRecordingTool: import("@cyanheads/mcp-ts-core").ToolDefi
|
|
|
47
60
|
}, z.core.$strip>, readonly [{
|
|
48
61
|
readonly reason: "invalid_mbid";
|
|
49
62
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
50
|
-
readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz
|
|
63
|
+
readonly when: "The MBID is malformed or the all-zeros sentinel (rejected before fetch), or MusicBrainz rejects it with HTTP 400.";
|
|
51
64
|
readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entityType=recording) to find one from a title.";
|
|
52
65
|
}, {
|
|
53
66
|
readonly reason: "entity_not_found";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-recording.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recording.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"get-recording.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recording.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA8BjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0J3B,CAAC"}
|
|
@@ -8,7 +8,8 @@
|
|
|
8
8
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
9
9
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
10
10
|
import { getMusicBrainzService } from '../../../services/musicbrainz/musicbrainz-service.js';
|
|
11
|
-
import {
|
|
11
|
+
import { summarizeReleaseAppearances } from '../../../services/musicbrainz/release-appearances.js';
|
|
12
|
+
import { ArtistCreditSchema, artistCreditString, classifyMbidError, ExternalLinkSchema, formatDuration, MBID_EXAMPLE, MbidInput, normalizeArtistCredits, normalizeRelations, RelationSchema, renderArtistCredits, renderExternalLinks, renderRelationships, safeText, } from './_shared.js';
|
|
12
13
|
const ReleaseAppearanceSchema = z
|
|
13
14
|
.object({
|
|
14
15
|
mbid: z.string().describe('Release MBID — chain to musicbrainz_get_release.'),
|
|
@@ -19,13 +20,13 @@ const ReleaseAppearanceSchema = z
|
|
|
19
20
|
.describe('A release this recording appears on.');
|
|
20
21
|
export const getRecordingTool = tool('musicbrainz_get_recording', {
|
|
21
22
|
title: 'musicbrainz-mcp-server: get recording',
|
|
22
|
-
description: 'Recording (a specific performance
|
|
23
|
+
description: 'Recording (a specific performance, distinct from the abstract work) by MBID: length, artist credits, ISRCs, one upstream page of release appearances with completeness metadata, work relationships, and performer/production credits with attributes and dates. Relationships are not capped. Enumerate releases with musicbrainz_browse_entities (target_type=release, link.recording, offset=0); embedded and browse order may differ. Browse recording by work enumerates recording entities; this tool supplies their work relationship details.',
|
|
23
24
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
|
|
24
25
|
errors: [
|
|
25
26
|
{
|
|
26
27
|
reason: 'invalid_mbid',
|
|
27
28
|
code: JsonRpcErrorCode.ValidationError,
|
|
28
|
-
when: 'The MBID is malformed or the all-zeros sentinel (MusicBrainz
|
|
29
|
+
when: 'The MBID is malformed or the all-zeros sentinel (rejected before fetch), or MusicBrainz rejects it with HTTP 400.',
|
|
29
30
|
recovery: `MBID must be a 36-character UUID (e.g. ${MBID_EXAMPLE}). Use musicbrainz_search_entities (entityType=recording) to find one from a title.`,
|
|
30
31
|
},
|
|
31
32
|
{
|
|
@@ -36,7 +37,7 @@ export const getRecordingTool = tool('musicbrainz_get_recording', {
|
|
|
36
37
|
},
|
|
37
38
|
],
|
|
38
39
|
input: z.object({
|
|
39
|
-
mbid:
|
|
40
|
+
mbid: MbidInput.describe('Recording MBID (hyphenated hexadecimal UUID; surrounding whitespace and uppercase accepted).'),
|
|
40
41
|
inc_relationships: z
|
|
41
42
|
.boolean()
|
|
42
43
|
.default(true)
|
|
@@ -58,7 +59,23 @@ export const getRecordingTool = tool('musicbrainz_get_recording', {
|
|
|
58
59
|
.describe('Earliest release date for this recording. Omitted when absent.'),
|
|
59
60
|
releases: z
|
|
60
61
|
.array(ReleaseAppearanceSchema)
|
|
61
|
-
.describe('
|
|
62
|
+
.describe('One upstream page of release appearances (up to 25; may be empty). See releaseAppearanceSummary for completeness.'),
|
|
63
|
+
releaseAppearanceSummary: z
|
|
64
|
+
.object({
|
|
65
|
+
shown: z.number().describe('Release appearances returned in the embedded page.'),
|
|
66
|
+
cap: z.number().describe('Upstream embedded page size (25).'),
|
|
67
|
+
completeness: z
|
|
68
|
+
.enum(['complete', 'unknown', 'truncated'])
|
|
69
|
+
.describe('Complete for a short present page or exact total; unknown without proof; truncated only when the exact total exceeds shown.'),
|
|
70
|
+
totalCount: z
|
|
71
|
+
.number()
|
|
72
|
+
.optional()
|
|
73
|
+
.describe('Exact release total from upstream or a short present page. Omitted when unknown.'),
|
|
74
|
+
notice: z
|
|
75
|
+
.string()
|
|
76
|
+
.describe('Browse guidance starting at offset 0, independent of embedded order.'),
|
|
77
|
+
})
|
|
78
|
+
.describe('Completeness evidence derived only from this recording lookup.'),
|
|
62
79
|
relationships: z
|
|
63
80
|
.array(RelationSchema)
|
|
64
81
|
.describe('Performance/production relationships and work-rels (may be empty).'),
|
|
@@ -105,6 +122,7 @@ export const getRecordingTool = tool('musicbrainz_get_recording', {
|
|
|
105
122
|
isrcs: raw.isrcs ?? [],
|
|
106
123
|
...(raw['first-release-date'] ? { firstReleaseDate: raw['first-release-date'] } : {}),
|
|
107
124
|
releases,
|
|
125
|
+
releaseAppearanceSummary: summarizeReleaseAppearances(raw),
|
|
108
126
|
relationships,
|
|
109
127
|
externalLinks,
|
|
110
128
|
};
|
|
@@ -122,6 +140,9 @@ export const getRecordingTool = tool('musicbrainz_get_recording', {
|
|
|
122
140
|
if (result.isrcs.length)
|
|
123
141
|
lines.push(`**ISRCs:** ${result.isrcs.join(', ')}`);
|
|
124
142
|
lines.push(...renderArtistCredits(result.artistCredit));
|
|
143
|
+
const summary = result.releaseAppearanceSummary;
|
|
144
|
+
lines.push(`**Release appearances:** ${summary.completeness} (shown: ${summary.shown}, cap: ${summary.cap}${summary.totalCount === undefined ? '' : `, totalCount: ${summary.totalCount}`})`);
|
|
145
|
+
lines.push(summary.notice);
|
|
125
146
|
if (result.releases.length) {
|
|
126
147
|
lines.push('', `### Appears on (${result.releases.length})`);
|
|
127
148
|
for (const r of result.releases) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-recording.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recording.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,+CAA+C,CAAC;
|
|
1
|
+
{"version":3,"file":"get-recording.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recording.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -52,7 +52,7 @@ export declare const getReleaseGroupTool: import("@cyanheads/mcp-ts-core").ToolD
|
|
|
52
52
|
}, z.core.$strip>, readonly [{
|
|
53
53
|
readonly reason: "invalid_mbid";
|
|
54
54
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
55
|
-
readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz
|
|
55
|
+
readonly when: "The MBID is malformed or the all-zeros sentinel (rejected before fetch), or MusicBrainz rejects it with HTTP 400.";
|
|
56
56
|
readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entityType=release-group) to find one from a title.";
|
|
57
57
|
}, {
|
|
58
58
|
readonly reason: "entity_not_found";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-release-group.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-release-group.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"get-release-group.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-release-group.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAkDjE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoM9B,CAAC"}
|
|
@@ -17,7 +17,7 @@ import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
|
17
17
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
18
18
|
import { getCoverArtService } from '../../../services/cover-art/cover-art-service.js';
|
|
19
19
|
import { getMusicBrainzService } from '../../../services/musicbrainz/musicbrainz-service.js';
|
|
20
|
-
import { ArtistCreditSchema, artistCreditString, CoverArtStubSchema, classifyMbidError, MBID_EXAMPLE, normalizeArtistCredits, normalizeTags, renderArtistCredits, renderCoverArtStub, renderTags, safeText, TagSchema, } from './_shared.js';
|
|
20
|
+
import { ArtistCreditSchema, artistCreditString, CoverArtStubSchema, classifyMbidError, MBID_EXAMPLE, MbidInput, normalizeArtistCredits, normalizeTags, renderArtistCredits, renderCoverArtStub, renderTags, safeText, TagSchema, } from './_shared.js';
|
|
21
21
|
const ReleaseRefSchema = z
|
|
22
22
|
.object({
|
|
23
23
|
mbid: z.string().describe('Release MBID — chain to musicbrainz_get_release for the tracklist.'),
|
|
@@ -52,7 +52,7 @@ export const getReleaseGroupTool = tool('musicbrainz_get_release_group', {
|
|
|
52
52
|
{
|
|
53
53
|
reason: 'invalid_mbid',
|
|
54
54
|
code: JsonRpcErrorCode.ValidationError,
|
|
55
|
-
when: 'The MBID is malformed or the all-zeros sentinel (MusicBrainz
|
|
55
|
+
when: 'The MBID is malformed or the all-zeros sentinel (rejected before fetch), or MusicBrainz rejects it with HTTP 400.',
|
|
56
56
|
recovery: `MBID must be a 36-character UUID (e.g. ${MBID_EXAMPLE}). Use musicbrainz_search_entities (entityType=release-group) to find one from a title.`,
|
|
57
57
|
},
|
|
58
58
|
{
|
|
@@ -63,7 +63,7 @@ export const getReleaseGroupTool = tool('musicbrainz_get_release_group', {
|
|
|
63
63
|
},
|
|
64
64
|
],
|
|
65
65
|
input: z.object({
|
|
66
|
-
mbid:
|
|
66
|
+
mbid: MbidInput.describe('Release-group MBID (hyphenated hexadecimal UUID; surrounding whitespace and uppercase accepted).'),
|
|
67
67
|
}),
|
|
68
68
|
output: z.object({
|
|
69
69
|
mbid: z.string().describe('Release-group MBID.'),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-release-group.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-release-group.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAEtF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAC;AAEtB,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IAC/F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACrF,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACxF,CAAC;KACD,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE7D,mFAAmF;AACnF,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,wFAAwF;AACxF,MAAM,uBAAuB,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAW,CAAC;AAE7E,0FAA0F;AAC1F,SAAS,kBAAkB,CAAC,MAA0B;IACpD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;QACnD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,+BAA+B,EAAE;IACvE,KAAK,EAAE,2CAA2C;IAClD,WAAW,EACT,4sBAA4sB;IAC9sB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAE9E,MAAM,EAAE;QACN;YACE,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"get-release-group.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-release-group.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @fileoverview musicbrainz_get_release — one edition's
|
|
3
|
-
*
|
|
2
|
+
* @fileoverview musicbrainz_get_release — one edition's detail by MBID:
|
|
3
|
+
* paged media (tracks → recordings with lengths and MBIDs), label + catalog
|
|
4
4
|
* number, barcode, country, release date, format, packaging, text representation,
|
|
5
5
|
* and a cover-art availability stub.
|
|
6
6
|
* @module mcp-server/tools/definitions/get-release.tool
|
|
@@ -9,6 +9,8 @@ import { z } from '@cyanheads/mcp-ts-core';
|
|
|
9
9
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
10
10
|
export declare const getReleaseTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
|
|
11
11
|
mbid: z.ZodString;
|
|
12
|
+
media_offset: z.ZodDefault<z.ZodNumber>;
|
|
13
|
+
media_limit: z.ZodDefault<z.ZodNumber>;
|
|
12
14
|
}, z.core.$strip>, z.ZodObject<{
|
|
13
15
|
mbid: z.ZodString;
|
|
14
16
|
title: z.ZodString;
|
|
@@ -33,6 +35,9 @@ export declare const getReleaseTool: import("@cyanheads/mcp-ts-core").ToolDefini
|
|
|
33
35
|
labelName: z.ZodOptional<z.ZodString>;
|
|
34
36
|
catalogNumber: z.ZodOptional<z.ZodString>;
|
|
35
37
|
}, z.core.$strip>>;
|
|
38
|
+
mediaOffset: z.ZodNumber;
|
|
39
|
+
mediaTotal: z.ZodNumber;
|
|
40
|
+
trackTotal: z.ZodNumber;
|
|
36
41
|
media: z.ZodArray<z.ZodObject<{
|
|
37
42
|
position: z.ZodOptional<z.ZodNumber>;
|
|
38
43
|
format: z.ZodOptional<z.ZodString>;
|
|
@@ -55,12 +60,17 @@ export declare const getReleaseTool: import("@cyanheads/mcp-ts-core").ToolDefini
|
|
|
55
60
|
}, z.core.$strip>, readonly [{
|
|
56
61
|
readonly reason: "invalid_mbid";
|
|
57
62
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
58
|
-
readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz
|
|
63
|
+
readonly when: "The MBID is malformed or the all-zeros sentinel (rejected before fetch), or MusicBrainz rejects it with HTTP 400.";
|
|
59
64
|
readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entityType=release) to find one from a title.";
|
|
60
65
|
}, {
|
|
61
66
|
readonly reason: "entity_not_found";
|
|
62
67
|
readonly code: JsonRpcErrorCode.NotFound;
|
|
63
68
|
readonly when: "The MBID is well-formed but no release exists with it (MusicBrainz returns HTTP 404).";
|
|
64
69
|
readonly recovery: "No release exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.";
|
|
65
|
-
}],
|
|
70
|
+
}], {
|
|
71
|
+
readonly truncated: z.ZodOptional<z.ZodBoolean>;
|
|
72
|
+
readonly shown: z.ZodOptional<z.ZodNumber>;
|
|
73
|
+
readonly cap: z.ZodOptional<z.ZodNumber>;
|
|
74
|
+
readonly notice: z.ZodOptional<z.ZodString>;
|
|
75
|
+
}>;
|
|
66
76
|
//# sourceMappingURL=get-release.tool.d.ts.map
|