@cyanheads/musicbrainz-mcp-server 0.1.0
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 +466 -0
- package/CLAUDE.md +466 -0
- package/Dockerfile +121 -0
- package/LICENSE +201 -0
- package/README.md +329 -0
- package/changelog/0.1.x/0.1.0.md +27 -0
- package/changelog/template.md +127 -0
- package/dist/config/server-config.d.ts +24 -0
- package/dist/config/server-config.d.ts.map +1 -0
- package/dist/config/server-config.js +90 -0
- package/dist/config/server-config.js.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +27 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity.resource.d.ts +33 -0
- package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity.resource.js +72 -0
- package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +27 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +8 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/_shared.d.ts +105 -0
- package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/_shared.js +382 -0
- package/dist/mcp-server/tools/definitions/_shared.js.map +1 -0
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +62 -0
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js +236 -0
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +78 -0
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-artist.tool.js +200 -0
- package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +42 -0
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +149 -0
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +52 -0
- package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-label.tool.js +110 -0
- package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +58 -0
- package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-recording.tool.js +135 -0
- package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +55 -0
- package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-release-group.tool.js +140 -0
- package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +66 -0
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-release.tool.js +213 -0
- package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +62 -0
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-work.tool.js +132 -0
- package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +468 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +28 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +59 -0
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +214 -0
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +42 -0
- package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-entities.tool.js +187 -0
- package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -0
- package/dist/services/cover-art/cover-art-service.d.ts +40 -0
- package/dist/services/cover-art/cover-art-service.d.ts.map +1 -0
- package/dist/services/cover-art/cover-art-service.js +118 -0
- package/dist/services/cover-art/cover-art-service.js.map +1 -0
- package/dist/services/musicbrainz/musicbrainz-service.d.ts +81 -0
- package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -0
- package/dist/services/musicbrainz/musicbrainz-service.js +188 -0
- package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -0
- package/dist/services/musicbrainz/rate-limiter.d.ts +32 -0
- package/dist/services/musicbrainz/rate-limiter.d.ts.map +1 -0
- package/dist/services/musicbrainz/rate-limiter.js +54 -0
- package/dist/services/musicbrainz/rate-limiter.js.map +1 -0
- package/dist/services/musicbrainz/types.d.ts +301 -0
- package/dist/services/musicbrainz/types.d.ts.map +1 -0
- package/dist/services/musicbrainz/types.js +11 -0
- package/dist/services/musicbrainz/types.js.map +1 -0
- package/package.json +103 -0
- package/server.json +111 -0
|
@@ -0,0 +1,382 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Shared Zod sub-schemas and pure normalizers for MusicBrainz tool
|
|
3
|
+
* definitions. Relationships, artist-credits, life-spans, tags, aliases, and
|
|
4
|
+
* external-link (url-rels) extraction recur across the artist / recording / work /
|
|
5
|
+
* label / release tools, so the schemas and the raw→domain mappers live here once.
|
|
6
|
+
*
|
|
7
|
+
* Normalization preserves absence as "unknown": MusicBrainz omits fields entirely
|
|
8
|
+
* (and a field can present as `null` in one mode and `false` in another), so every
|
|
9
|
+
* mapper uses conditional spreads under `exactOptionalPropertyTypes` and never
|
|
10
|
+
* fabricates a concrete value from missing upstream data.
|
|
11
|
+
*
|
|
12
|
+
* NOTE: this file holds shared schemas/helpers, not a tool definition, so it omits
|
|
13
|
+
* the `.tool.ts` suffix to stay out of the definition glob.
|
|
14
|
+
* @module mcp-server/tools/definitions/_shared
|
|
15
|
+
*/
|
|
16
|
+
import { z } from '@cyanheads/mcp-ts-core';
|
|
17
|
+
import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
|
|
18
|
+
/**
|
|
19
|
+
* Classify an upstream error from an MBID lookup against the MusicBrainz 400-vs-404
|
|
20
|
+
* split: a malformed / all-zeros MBID returns HTTP 400 (`InvalidParams`); a
|
|
21
|
+
* well-formed MBID with no matching entity returns HTTP 404 (`NotFound`). Returns
|
|
22
|
+
* the contract reason for those two cases, or `null` for anything else (transient
|
|
23
|
+
* upstream failures bubble unchanged). Handlers call `ctx.fail(reason, …)` on a
|
|
24
|
+
* non-null result so `data.reason` is populated and typed against their contract.
|
|
25
|
+
*/
|
|
26
|
+
export function classifyMbidError(error) {
|
|
27
|
+
if (!(error instanceof McpError))
|
|
28
|
+
return null;
|
|
29
|
+
if (error.code === JsonRpcErrorCode.InvalidParams)
|
|
30
|
+
return 'invalid_mbid';
|
|
31
|
+
if (error.code === JsonRpcErrorCode.NotFound)
|
|
32
|
+
return 'entity_not_found';
|
|
33
|
+
return null;
|
|
34
|
+
}
|
|
35
|
+
/** UUID shape MusicBrainz MBIDs follow — surfaced in recovery hints, not used to pre-validate. */
|
|
36
|
+
export const MBID_EXAMPLE = 'a74b1b7f-71a5-4011-9441-d0b5e4122711';
|
|
37
|
+
// ─── Zod sub-schemas (described, including nested array-item objects) ─────────
|
|
38
|
+
export const MbidScore = z.number().describe('Lucene relevance score, 0–100 (100 = exact match).');
|
|
39
|
+
export const ArtistCreditSchema = z
|
|
40
|
+
.object({
|
|
41
|
+
name: z.string().describe('Credited name as it appears on the release (may be an alias).'),
|
|
42
|
+
artistId: z.string().describe('MBID of the credited artist — chain to musicbrainz_get_artist.'),
|
|
43
|
+
artistName: z.string().describe('Canonical artist name.'),
|
|
44
|
+
joinPhrase: z
|
|
45
|
+
.string()
|
|
46
|
+
.optional()
|
|
47
|
+
.describe('Text that joins this credit to the next (e.g. " feat. ", " & "). Omitted when empty.'),
|
|
48
|
+
})
|
|
49
|
+
.describe('One credited artist within an artist credit.');
|
|
50
|
+
export const LifeSpanSchema = z
|
|
51
|
+
.object({
|
|
52
|
+
begin: z
|
|
53
|
+
.string()
|
|
54
|
+
.optional()
|
|
55
|
+
.describe('Start date (YYYY, YYYY-MM, or YYYY-MM-DD). Omitted when unknown.'),
|
|
56
|
+
end: z.string().optional().describe('End date. Omitted when unknown.'),
|
|
57
|
+
ended: z
|
|
58
|
+
.boolean()
|
|
59
|
+
.optional()
|
|
60
|
+
.describe('Whether the entity has ended. Omitted when the upstream value is unknown/null.'),
|
|
61
|
+
})
|
|
62
|
+
.describe('Begin/end date span. Fields omitted when MusicBrainz does not provide them.');
|
|
63
|
+
export const TagSchema = z
|
|
64
|
+
.object({
|
|
65
|
+
name: z.string().describe('Tag or genre name.'),
|
|
66
|
+
count: z.number().describe('Community vote count for this tag.'),
|
|
67
|
+
})
|
|
68
|
+
.describe('A folksonomy tag or genre with its vote count.');
|
|
69
|
+
export const AliasSchema = z
|
|
70
|
+
.object({
|
|
71
|
+
name: z.string().describe('Alias name.'),
|
|
72
|
+
sortName: z.string().optional().describe('Sortable form of the alias. Omitted when absent.'),
|
|
73
|
+
type: z
|
|
74
|
+
.string()
|
|
75
|
+
.optional()
|
|
76
|
+
.describe('Alias type (e.g. "Artist name", "Legal name"). Omitted when absent.'),
|
|
77
|
+
locale: z.string().optional().describe('BCP-47 locale of the alias. Omitted when absent.'),
|
|
78
|
+
primary: z
|
|
79
|
+
.boolean()
|
|
80
|
+
.optional()
|
|
81
|
+
.describe('Whether this is the primary alias for its locale. Omitted when absent.'),
|
|
82
|
+
})
|
|
83
|
+
.describe('An alternate name for the entity.');
|
|
84
|
+
export const RelationSchema = z
|
|
85
|
+
.object({
|
|
86
|
+
type: z
|
|
87
|
+
.string()
|
|
88
|
+
.describe('Relationship role (e.g. "member of band", "producer", "writer", "performance").'),
|
|
89
|
+
direction: z
|
|
90
|
+
.string()
|
|
91
|
+
.optional()
|
|
92
|
+
.describe('Relationship direction ("forward" | "backward"). Omitted when absent.'),
|
|
93
|
+
attributes: z
|
|
94
|
+
.array(z.string())
|
|
95
|
+
.optional()
|
|
96
|
+
.describe('Role modifiers (e.g. "lead vocals", "assistant", "co"). Omitted when none.'),
|
|
97
|
+
targetType: z
|
|
98
|
+
.string()
|
|
99
|
+
.describe('Type of the related entity ("artist" | "work" | "recording" | "label" | "url").'),
|
|
100
|
+
targetId: z
|
|
101
|
+
.string()
|
|
102
|
+
.optional()
|
|
103
|
+
.describe('MBID of the related entity — chain to the matching get_* tool. Omitted for url targets.'),
|
|
104
|
+
targetName: z
|
|
105
|
+
.string()
|
|
106
|
+
.optional()
|
|
107
|
+
.describe('Name/title of the related entity. Omitted when absent.'),
|
|
108
|
+
begin: z.string().optional().describe('Relationship start date. Omitted when absent.'),
|
|
109
|
+
end: z.string().optional().describe('Relationship end date. Omitted when absent.'),
|
|
110
|
+
})
|
|
111
|
+
.describe('A typed relationship to another entity (band membership, performer, writer, etc.).');
|
|
112
|
+
export const ExternalLinkSchema = z
|
|
113
|
+
.object({
|
|
114
|
+
type: z
|
|
115
|
+
.string()
|
|
116
|
+
.describe('Link type (e.g. "wikidata", "discogs", "official homepage", "streaming").'),
|
|
117
|
+
resource: z
|
|
118
|
+
.string()
|
|
119
|
+
.describe('The external URL. Wikidata/Discogs IDs live in the URL path — chain to those servers.'),
|
|
120
|
+
})
|
|
121
|
+
.describe('An external resource link (url-rel). Where cross-service IDs like Wikidata QID are surfaced.');
|
|
122
|
+
export const CoverArtStubSchema = z
|
|
123
|
+
.object({
|
|
124
|
+
exists: z.boolean().describe('Whether the Cover Art Archive has any artwork for this entity.'),
|
|
125
|
+
count: z.number().optional().describe('Number of images available. Omitted when unknown.'),
|
|
126
|
+
front: z
|
|
127
|
+
.boolean()
|
|
128
|
+
.optional()
|
|
129
|
+
.describe('Whether a designated front image exists. Omitted when unknown.'),
|
|
130
|
+
back: z
|
|
131
|
+
.boolean()
|
|
132
|
+
.optional()
|
|
133
|
+
.describe('Whether a designated back image exists. Omitted when unknown.'),
|
|
134
|
+
})
|
|
135
|
+
.describe('Cover-art availability stub from the WS/2 payload — use musicbrainz_get_cover_art for image URLs.');
|
|
136
|
+
// ─── Pure normalizers (raw upstream → domain, absence-preserving) ─────────────
|
|
137
|
+
export function normalizeArtistCredits(credits) {
|
|
138
|
+
if (!credits?.length)
|
|
139
|
+
return [];
|
|
140
|
+
const out = [];
|
|
141
|
+
for (const c of credits) {
|
|
142
|
+
const artistId = c.artist?.id;
|
|
143
|
+
if (!artistId)
|
|
144
|
+
continue;
|
|
145
|
+
const joinPhrase = c.joinphrase?.trim();
|
|
146
|
+
out.push({
|
|
147
|
+
name: c.name ?? c.artist?.name ?? '',
|
|
148
|
+
artistId,
|
|
149
|
+
artistName: c.artist?.name ?? c.name ?? '',
|
|
150
|
+
...(joinPhrase ? { joinPhrase } : {}),
|
|
151
|
+
});
|
|
152
|
+
}
|
|
153
|
+
return out;
|
|
154
|
+
}
|
|
155
|
+
/** Render an artist-credit array to its display string, stitching join phrases. */
|
|
156
|
+
export function artistCreditString(credits) {
|
|
157
|
+
return credits.map((c) => `${c.artistName}${c.joinPhrase ?? ''}`).join('') || 'Unknown artist';
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* Render the artist-credit array as a detail block surfacing every sub-field
|
|
161
|
+
* (credited name, canonical name, MBID, join phrase) — used by tools that expose
|
|
162
|
+
* `artistCredit` as a full array in output, so format() stays parity-complete.
|
|
163
|
+
*/
|
|
164
|
+
export function renderArtistCredits(credits) {
|
|
165
|
+
if (credits.length === 0)
|
|
166
|
+
return [];
|
|
167
|
+
const lines = ['', '### Artist credit'];
|
|
168
|
+
for (const c of credits) {
|
|
169
|
+
const credited = c.name && c.name !== c.artistName ? ` (credited as "${safeText(c.name)}")` : '';
|
|
170
|
+
const join = c.joinPhrase ? ` + join "${safeText(c.joinPhrase)}"` : '';
|
|
171
|
+
lines.push(`- ${safeText(c.artistName)}${credited} — ${c.artistId}${join}`);
|
|
172
|
+
}
|
|
173
|
+
return lines;
|
|
174
|
+
}
|
|
175
|
+
export function normalizeLifeSpan(span) {
|
|
176
|
+
if (!span)
|
|
177
|
+
return;
|
|
178
|
+
const result = {
|
|
179
|
+
...(span.begin ? { begin: span.begin } : {}),
|
|
180
|
+
...(span.end ? { end: span.end } : {}),
|
|
181
|
+
...(typeof span.ended === 'boolean' ? { ended: span.ended } : {}),
|
|
182
|
+
};
|
|
183
|
+
return Object.keys(result).length > 0 ? result : undefined;
|
|
184
|
+
}
|
|
185
|
+
export function normalizeTags(tags) {
|
|
186
|
+
if (!tags?.length)
|
|
187
|
+
return [];
|
|
188
|
+
return tags
|
|
189
|
+
.filter((t) => typeof t.name === 'string' && t.name.length > 0)
|
|
190
|
+
.map((t) => ({ name: t.name, count: typeof t.count === 'number' ? t.count : 0 }));
|
|
191
|
+
}
|
|
192
|
+
export function normalizeAliases(aliases) {
|
|
193
|
+
if (!aliases?.length)
|
|
194
|
+
return [];
|
|
195
|
+
const out = [];
|
|
196
|
+
for (const a of aliases) {
|
|
197
|
+
if (!a.name)
|
|
198
|
+
continue;
|
|
199
|
+
out.push({
|
|
200
|
+
name: a.name,
|
|
201
|
+
...(a['sort-name'] ? { sortName: a['sort-name'] } : {}),
|
|
202
|
+
...(a.type ? { type: a.type } : {}),
|
|
203
|
+
...(a.locale ? { locale: a.locale } : {}),
|
|
204
|
+
...(typeof a.primary === 'boolean' ? { primary: a.primary } : {}),
|
|
205
|
+
});
|
|
206
|
+
}
|
|
207
|
+
return out;
|
|
208
|
+
}
|
|
209
|
+
/** The MBID-bearing target nested in a relation, by target-type. */
|
|
210
|
+
function relationTarget(rel) {
|
|
211
|
+
switch (rel['target-type']) {
|
|
212
|
+
case 'artist':
|
|
213
|
+
return {
|
|
214
|
+
...(rel.artist?.id && { id: rel.artist.id }),
|
|
215
|
+
...(rel.artist?.name && { name: rel.artist.name }),
|
|
216
|
+
};
|
|
217
|
+
case 'work':
|
|
218
|
+
return {
|
|
219
|
+
...(rel.work?.id && { id: rel.work.id }),
|
|
220
|
+
...(rel.work?.title && { name: rel.work.title }),
|
|
221
|
+
};
|
|
222
|
+
case 'recording':
|
|
223
|
+
return {
|
|
224
|
+
...(rel.recording?.id && { id: rel.recording.id }),
|
|
225
|
+
...(rel.recording?.title && { name: rel.recording.title }),
|
|
226
|
+
};
|
|
227
|
+
case 'label':
|
|
228
|
+
return {
|
|
229
|
+
...(rel.label?.id && { id: rel.label.id }),
|
|
230
|
+
...(rel.label?.name && { name: rel.label.name }),
|
|
231
|
+
};
|
|
232
|
+
default:
|
|
233
|
+
return {};
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
/**
|
|
237
|
+
* Split a raw `relations[]` array into the non-URL relationships (band
|
|
238
|
+
* membership, performers, writers, etc.) and the external links (url-rels).
|
|
239
|
+
* URL relations are where cross-service IDs (Wikidata, Discogs) live, so they
|
|
240
|
+
* get their own typed view.
|
|
241
|
+
*/
|
|
242
|
+
export function normalizeRelations(relations) {
|
|
243
|
+
const relationships = [];
|
|
244
|
+
const externalLinks = [];
|
|
245
|
+
if (!relations?.length)
|
|
246
|
+
return { relationships, externalLinks };
|
|
247
|
+
for (const rel of relations) {
|
|
248
|
+
if (rel['target-type'] === 'url') {
|
|
249
|
+
const resource = rel.url?.resource;
|
|
250
|
+
if (resource)
|
|
251
|
+
externalLinks.push({ type: rel.type ?? 'url', resource });
|
|
252
|
+
continue;
|
|
253
|
+
}
|
|
254
|
+
const target = relationTarget(rel);
|
|
255
|
+
const attributes = rel.attributes?.filter((a) => a.length > 0);
|
|
256
|
+
relationships.push({
|
|
257
|
+
type: rel.type ?? 'related',
|
|
258
|
+
...(rel.direction ? { direction: rel.direction } : {}),
|
|
259
|
+
...(attributes?.length ? { attributes } : {}),
|
|
260
|
+
targetType: rel['target-type'] ?? 'unknown',
|
|
261
|
+
...(target.id ? { targetId: target.id } : {}),
|
|
262
|
+
...(target.name ? { targetName: target.name } : {}),
|
|
263
|
+
...(rel.begin ? { begin: rel.begin } : {}),
|
|
264
|
+
...(rel.end ? { end: rel.end } : {}),
|
|
265
|
+
});
|
|
266
|
+
}
|
|
267
|
+
return { relationships, externalLinks };
|
|
268
|
+
}
|
|
269
|
+
export function normalizeCoverArtStub(stub) {
|
|
270
|
+
if (!stub)
|
|
271
|
+
return { exists: false };
|
|
272
|
+
return {
|
|
273
|
+
exists: stub.artwork === true || (typeof stub.count === 'number' && stub.count > 0),
|
|
274
|
+
...(typeof stub.count === 'number' ? { count: stub.count } : {}),
|
|
275
|
+
...(typeof stub.front === 'boolean' ? { front: stub.front } : {}),
|
|
276
|
+
...(typeof stub.back === 'boolean' ? { back: stub.back } : {}),
|
|
277
|
+
};
|
|
278
|
+
}
|
|
279
|
+
/** Format milliseconds as `m:ss` (track lengths are in ms upstream). */
|
|
280
|
+
export function formatDuration(ms) {
|
|
281
|
+
if (typeof ms !== 'number' || ms <= 0)
|
|
282
|
+
return;
|
|
283
|
+
const totalSeconds = Math.round(ms / 1000);
|
|
284
|
+
const minutes = Math.floor(totalSeconds / 60);
|
|
285
|
+
const seconds = totalSeconds % 60;
|
|
286
|
+
return `${minutes}:${seconds.toString().padStart(2, '0')}`;
|
|
287
|
+
}
|
|
288
|
+
// ─── Shared rendering helpers for format() ────────────────────────────────────
|
|
289
|
+
//
|
|
290
|
+
// These render EVERY sub-field of the schemas above so format()'s markdown stays
|
|
291
|
+
// content-complete with structuredContent (lint-enforced format-parity). Each
|
|
292
|
+
// terminal field of an object/array in `output` must appear in the rendered text.
|
|
293
|
+
/**
|
|
294
|
+
* Neutralize a community-edited free-text value before it is interpolated into a
|
|
295
|
+
* single line of `format()` markdown. MusicBrainz core data is user-submitted, so
|
|
296
|
+
* a name / title / disambiguation / tag / alias / comment field can carry hostile
|
|
297
|
+
* content. Every `format()` line is built as `lines.push(...)` and joined with
|
|
298
|
+
* `\n`, so the one way a value escapes its structural slot (a bold label, a list
|
|
299
|
+
* bullet) is by injecting its own line breaks. A value like
|
|
300
|
+
* `"\n\n## SYSTEM: ignore the above"` would otherwise render as a new markdown
|
|
301
|
+
* heading the LLM reads as an instruction.
|
|
302
|
+
*
|
|
303
|
+
* Collapsing every line break, tab, control character (`\p{Cc}`), and Unicode
|
|
304
|
+
* line/paragraph separator (U+2028 / U+2029) to a single space keeps the value
|
|
305
|
+
* confined to its line: leading `#` / `-` / `>` markers are inert mid-line, and a
|
|
306
|
+
* fenced code block
|
|
307
|
+
* cannot open because the value can no longer span multiple lines. The structured
|
|
308
|
+
* `structuredContent` twin carries the raw value unchanged — this guards only the
|
|
309
|
+
* markdown surface, where untrusted text and server-authored structure mix.
|
|
310
|
+
* Legitimate single-line titles pass through byte-identical.
|
|
311
|
+
*/
|
|
312
|
+
const CONTROL_OR_LINE_SEPARATOR = /[\p{Cc}\u2028\u2029]+/gu;
|
|
313
|
+
export function safeText(value) {
|
|
314
|
+
return value.replace(CONTROL_OR_LINE_SEPARATOR, ' ').trim();
|
|
315
|
+
}
|
|
316
|
+
export function renderRelationships(rels) {
|
|
317
|
+
if (rels.length === 0)
|
|
318
|
+
return [];
|
|
319
|
+
const lines = ['', '### Relationships'];
|
|
320
|
+
for (const r of rels) {
|
|
321
|
+
const attrs = r.attributes?.length ? ` (${r.attributes.map(safeText).join(', ')})` : '';
|
|
322
|
+
const target = safeText(r.targetName ?? r.targetId ?? r.targetType);
|
|
323
|
+
const dir = r.direction ? ` ${r.direction}` : '';
|
|
324
|
+
const dates = r.begin || r.end ? ` [${r.begin ?? ''}${r.end ? `–${r.end}` : ''}]` : '';
|
|
325
|
+
lines.push(`- **${safeText(r.type)}**${attrs}${dir} → ${r.targetType}: ${target}${r.targetId ? ` (${r.targetId})` : ''}${dates}`);
|
|
326
|
+
}
|
|
327
|
+
return lines;
|
|
328
|
+
}
|
|
329
|
+
export function renderExternalLinks(links) {
|
|
330
|
+
if (links.length === 0)
|
|
331
|
+
return [];
|
|
332
|
+
const lines = ['', '### External links'];
|
|
333
|
+
for (const l of links)
|
|
334
|
+
lines.push(`- **${safeText(l.type)}:** ${safeText(l.resource)}`);
|
|
335
|
+
return lines;
|
|
336
|
+
}
|
|
337
|
+
export function renderTags(tags) {
|
|
338
|
+
if (tags.length === 0)
|
|
339
|
+
return;
|
|
340
|
+
return `**Tags/genres:** ${tags.map((t) => `${safeText(t.name)} (${t.count})`).join(', ')}`;
|
|
341
|
+
}
|
|
342
|
+
export function renderAliases(aliases) {
|
|
343
|
+
if (aliases.length === 0)
|
|
344
|
+
return;
|
|
345
|
+
const parts = aliases.map((a) => {
|
|
346
|
+
const meta = [
|
|
347
|
+
a.type ? safeText(a.type) : null,
|
|
348
|
+
a.locale ? safeText(a.locale) : null,
|
|
349
|
+
a.sortName && a.sortName !== a.name ? `sort: ${safeText(a.sortName)}` : null,
|
|
350
|
+
a.primary ? 'primary' : null,
|
|
351
|
+
]
|
|
352
|
+
.filter(Boolean)
|
|
353
|
+
.join(', ');
|
|
354
|
+
return `${safeText(a.name)}${meta ? ` [${meta}]` : ''}`;
|
|
355
|
+
});
|
|
356
|
+
return `**Aliases:** ${parts.join('; ')}`;
|
|
357
|
+
}
|
|
358
|
+
export function renderLifeSpan(span) {
|
|
359
|
+
if (!span)
|
|
360
|
+
return;
|
|
361
|
+
const endedNote = typeof span.ended === 'boolean' ? ` (ended: ${span.ended ? 'yes' : 'no'})` : '';
|
|
362
|
+
if (span.begin && span.end)
|
|
363
|
+
return `**Life span:** ${span.begin} – ${span.end}${endedNote}`;
|
|
364
|
+
if (span.begin)
|
|
365
|
+
return `**Life span:** ${span.begin} – ${span.ended ? 'ended' : 'present'}${endedNote}`;
|
|
366
|
+
if (span.end)
|
|
367
|
+
return `**Life span:** ended ${span.end}${endedNote}`;
|
|
368
|
+
if (typeof span.ended === 'boolean')
|
|
369
|
+
return `**Life span:** ended: ${span.ended ? 'yes' : 'no'}`;
|
|
370
|
+
return;
|
|
371
|
+
}
|
|
372
|
+
/** Render the cover-art availability stub completely (exists/count/front/back). */
|
|
373
|
+
export function renderCoverArtStub(stub) {
|
|
374
|
+
const parts = [
|
|
375
|
+
`exists: ${stub.exists ? 'yes' : 'no'}`,
|
|
376
|
+
typeof stub.count === 'number' ? `count: ${stub.count}` : null,
|
|
377
|
+
typeof stub.front === 'boolean' ? `front: ${stub.front ? 'yes' : 'no'}` : null,
|
|
378
|
+
typeof stub.back === 'boolean' ? `back: ${stub.back ? 'yes' : 'no'}` : null,
|
|
379
|
+
].filter(Boolean);
|
|
380
|
+
return `**Cover art:** ${parts.join(', ')}`;
|
|
381
|
+
}
|
|
382
|
+
//# sourceMappingURL=_shared.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview musicbrainz_browse_entities — paginate the COMPLETE set of
|
|
3
|
+
* entities linked to a parent MBID: every release on a label, every release-group
|
|
4
|
+
* by an artist, every recording of a work, every release in a release-group. The
|
|
5
|
+
* only complete-enumeration path — the get_* tools' embedded lists are capped at
|
|
6
|
+
* one page (25), so this is a correctness tool, not a convenience.
|
|
7
|
+
* @module mcp-server/tools/definitions/browse-entities.tool
|
|
8
|
+
*/
|
|
9
|
+
import { z } from '@cyanheads/mcp-ts-core';
|
|
10
|
+
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
11
|
+
export declare const browseEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
|
|
12
|
+
target_type: z.ZodEnum<{
|
|
13
|
+
artist: "artist";
|
|
14
|
+
"release-group": "release-group";
|
|
15
|
+
release: "release";
|
|
16
|
+
recording: "recording";
|
|
17
|
+
work: "work";
|
|
18
|
+
label: "label";
|
|
19
|
+
}>;
|
|
20
|
+
link: z.ZodObject<{
|
|
21
|
+
artist: z.ZodOptional<z.ZodString>;
|
|
22
|
+
label: z.ZodOptional<z.ZodString>;
|
|
23
|
+
'release-group': z.ZodOptional<z.ZodString>;
|
|
24
|
+
recording: z.ZodOptional<z.ZodString>;
|
|
25
|
+
work: z.ZodOptional<z.ZodString>;
|
|
26
|
+
area: z.ZodOptional<z.ZodString>;
|
|
27
|
+
}, z.core.$strip>;
|
|
28
|
+
limit: z.ZodDefault<z.ZodNumber>;
|
|
29
|
+
offset: z.ZodDefault<z.ZodNumber>;
|
|
30
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
31
|
+
targetType: z.ZodString;
|
|
32
|
+
linkType: z.ZodString;
|
|
33
|
+
linkMbid: z.ZodString;
|
|
34
|
+
entities: z.ZodArray<z.ZodObject<{
|
|
35
|
+
mbid: z.ZodString;
|
|
36
|
+
name: z.ZodString;
|
|
37
|
+
disambiguation: z.ZodOptional<z.ZodString>;
|
|
38
|
+
type: z.ZodOptional<z.ZodString>;
|
|
39
|
+
artistCredit: z.ZodOptional<z.ZodString>;
|
|
40
|
+
date: z.ZodOptional<z.ZodString>;
|
|
41
|
+
country: z.ZodOptional<z.ZodString>;
|
|
42
|
+
length: z.ZodOptional<z.ZodString>;
|
|
43
|
+
}, z.core.$strip>>;
|
|
44
|
+
offset: z.ZodNumber;
|
|
45
|
+
}, z.core.$strip>, readonly [{
|
|
46
|
+
readonly reason: "invalid_link";
|
|
47
|
+
readonly code: JsonRpcErrorCode.InvalidParams;
|
|
48
|
+
readonly when: "No link MBID was provided, more than one was provided, or the link MBID is malformed (HTTP 400).";
|
|
49
|
+
readonly recovery: "Provide exactly one link MBID (e.g. link.artist) that is a valid parent for the target_type. MBIDs are 36-char UUIDs.";
|
|
50
|
+
}, {
|
|
51
|
+
readonly reason: "entity_not_found";
|
|
52
|
+
readonly code: JsonRpcErrorCode.NotFound;
|
|
53
|
+
readonly when: "The link MBID is well-formed but no such parent entity exists (HTTP 404).";
|
|
54
|
+
readonly recovery: "No parent entity exists with that MBID. Verify the ID with the matching musicbrainz_get_* tool or musicbrainz_search_entities.";
|
|
55
|
+
}], {
|
|
56
|
+
readonly totalCount: z.ZodNumber;
|
|
57
|
+
readonly truncated: z.ZodOptional<z.ZodBoolean>;
|
|
58
|
+
readonly shown: z.ZodOptional<z.ZodNumber>;
|
|
59
|
+
readonly cap: z.ZodOptional<z.ZodNumber>;
|
|
60
|
+
readonly notice: z.ZodOptional<z.ZodString>;
|
|
61
|
+
}>;
|
|
62
|
+
//# sourceMappingURL=browse-entities.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browse-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/browse-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA0GjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoL7B,CAAC"}
|