@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.
Files changed (89) hide show
  1. package/AGENTS.md +466 -0
  2. package/CLAUDE.md +466 -0
  3. package/Dockerfile +121 -0
  4. package/LICENSE +201 -0
  5. package/README.md +329 -0
  6. package/changelog/0.1.x/0.1.0.md +27 -0
  7. package/changelog/template.md +127 -0
  8. package/dist/config/server-config.d.ts +24 -0
  9. package/dist/config/server-config.d.ts.map +1 -0
  10. package/dist/config/server-config.js +90 -0
  11. package/dist/config/server-config.js.map +1 -0
  12. package/dist/index.d.ts +10 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +27 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/mcp-server/resources/definitions/entity.resource.d.ts +33 -0
  17. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -0
  18. package/dist/mcp-server/resources/definitions/entity.resource.js +72 -0
  19. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -0
  20. package/dist/mcp-server/resources/definitions/index.d.ts +27 -0
  21. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  22. package/dist/mcp-server/resources/definitions/index.js +8 -0
  23. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  24. package/dist/mcp-server/tools/definitions/_shared.d.ts +105 -0
  25. package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -0
  26. package/dist/mcp-server/tools/definitions/_shared.js +382 -0
  27. package/dist/mcp-server/tools/definitions/_shared.js.map +1 -0
  28. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +62 -0
  29. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -0
  30. package/dist/mcp-server/tools/definitions/browse-entities.tool.js +236 -0
  31. package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -0
  32. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +78 -0
  33. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -0
  34. package/dist/mcp-server/tools/definitions/get-artist.tool.js +200 -0
  35. package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -0
  36. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +42 -0
  37. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -0
  38. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +149 -0
  39. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -0
  40. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +52 -0
  41. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -0
  42. package/dist/mcp-server/tools/definitions/get-label.tool.js +110 -0
  43. package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -0
  44. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +58 -0
  45. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -0
  46. package/dist/mcp-server/tools/definitions/get-recording.tool.js +135 -0
  47. package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -0
  48. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +55 -0
  49. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -0
  50. package/dist/mcp-server/tools/definitions/get-release-group.tool.js +140 -0
  51. package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -0
  52. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +66 -0
  53. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -0
  54. package/dist/mcp-server/tools/definitions/get-release.tool.js +213 -0
  55. package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -0
  56. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +62 -0
  57. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -0
  58. package/dist/mcp-server/tools/definitions/get-work.tool.js +132 -0
  59. package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -0
  60. package/dist/mcp-server/tools/definitions/index.d.ts +468 -0
  61. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  62. package/dist/mcp-server/tools/definitions/index.js +28 -0
  63. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  64. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +59 -0
  65. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -0
  66. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +214 -0
  67. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -0
  68. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +42 -0
  69. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -0
  70. package/dist/mcp-server/tools/definitions/search-entities.tool.js +187 -0
  71. package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -0
  72. package/dist/services/cover-art/cover-art-service.d.ts +40 -0
  73. package/dist/services/cover-art/cover-art-service.d.ts.map +1 -0
  74. package/dist/services/cover-art/cover-art-service.js +118 -0
  75. package/dist/services/cover-art/cover-art-service.js.map +1 -0
  76. package/dist/services/musicbrainz/musicbrainz-service.d.ts +81 -0
  77. package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -0
  78. package/dist/services/musicbrainz/musicbrainz-service.js +188 -0
  79. package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -0
  80. package/dist/services/musicbrainz/rate-limiter.d.ts +32 -0
  81. package/dist/services/musicbrainz/rate-limiter.d.ts.map +1 -0
  82. package/dist/services/musicbrainz/rate-limiter.js +54 -0
  83. package/dist/services/musicbrainz/rate-limiter.js.map +1 -0
  84. package/dist/services/musicbrainz/types.d.ts +301 -0
  85. package/dist/services/musicbrainz/types.d.ts.map +1 -0
  86. package/dist/services/musicbrainz/types.js +11 -0
  87. package/dist/services/musicbrainz/types.js.map +1 -0
  88. package/package.json +103 -0
  89. package/server.json +111 -0
@@ -0,0 +1,140 @@
1
+ /**
2
+ * @fileoverview musicbrainz_get_release_group — release-group ("the album" above
3
+ * specific pressings) by MBID: primary + secondary type, first-release date,
4
+ * artist credit, the list of releases (editions), tags/genres, and whether cover
5
+ * art exists. Use musicbrainz_get_release for a specific edition's tracklist.
6
+ * @module mcp-server/tools/definitions/get-release-group.tool
7
+ */
8
+ import { tool, z } from '@cyanheads/mcp-ts-core';
9
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
10
+ import { getMusicBrainzService } from '../../../services/musicbrainz/musicbrainz-service.js';
11
+ import { ArtistCreditSchema, artistCreditString, CoverArtStubSchema, classifyMbidError, MBID_EXAMPLE, normalizeArtistCredits, normalizeCoverArtStub, normalizeTags, renderArtistCredits, renderCoverArtStub, renderTags, safeText, TagSchema, } from './_shared.js';
12
+ const ReleaseRefSchema = z
13
+ .object({
14
+ mbid: z.string().describe('Release MBID — chain to musicbrainz_get_release for the tracklist.'),
15
+ title: z.string().describe('Release (edition) title.'),
16
+ date: z.string().optional().describe('Release date. Omitted when absent.'),
17
+ country: z.string().optional().describe('Release country code. Omitted when absent.'),
18
+ status: z
19
+ .string()
20
+ .optional()
21
+ .describe('Release status (Official, Promotion, …). Omitted when absent.'),
22
+ disambiguation: z.string().optional().describe('Short qualifier. Omitted when absent.'),
23
+ })
24
+ .describe('A release (edition) within the release-group.');
25
+ export const getReleaseGroupTool = tool('musicbrainz_get_release_group', {
26
+ title: 'musicbrainz-mcp-server: get release group',
27
+ description: 'Release-group ("the album" above specific pressings) by MBID: primary type (Album/Single/EP) and secondary types (Live/Compilation), first-release date, artist credit, the list of releases (editions), tags/genres, and a cover-art availability flag from the WS/2 payload (use musicbrainz_get_cover_art for actual image URLs). For a specific edition\'s tracklist, take a release MBID from the releases list and call musicbrainz_get_release.',
28
+ annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
29
+ errors: [
30
+ {
31
+ reason: 'invalid_mbid',
32
+ code: JsonRpcErrorCode.InvalidParams,
33
+ when: 'The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).',
34
+ recovery: `MBID must be a 36-character UUID (e.g. ${MBID_EXAMPLE}). Use musicbrainz_search_entities (entity_type=release-group) to find one from a title.`,
35
+ },
36
+ {
37
+ reason: 'entity_not_found',
38
+ code: JsonRpcErrorCode.NotFound,
39
+ when: 'The MBID is well-formed but no release-group exists with it (MusicBrainz returns HTTP 404).',
40
+ recovery: 'No release-group exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.',
41
+ },
42
+ ],
43
+ input: z.object({
44
+ mbid: z.string().describe('Release-group MBID (36-character UUID).'),
45
+ }),
46
+ output: z.object({
47
+ mbid: z.string().describe('Release-group MBID.'),
48
+ title: z.string().describe('Release-group title.'),
49
+ disambiguation: z.string().optional().describe('Short qualifier. Omitted when absent.'),
50
+ primaryType: z
51
+ .string()
52
+ .optional()
53
+ .describe('Primary type (Album, Single, EP, Broadcast, Other). Omitted when absent.'),
54
+ secondaryTypes: z
55
+ .array(z.string())
56
+ .optional()
57
+ .describe('Secondary types (Live, Compilation, Soundtrack, …). Omitted when none.'),
58
+ firstReleaseDate: z
59
+ .string()
60
+ .optional()
61
+ .describe('Earliest release date across all editions. Omitted when absent.'),
62
+ artistCredit: z.array(ArtistCreditSchema).describe('Credited artists (may be empty).'),
63
+ artistCreditString: z
64
+ .string()
65
+ .describe('Display string of the artist credit with join phrases.'),
66
+ releases: z
67
+ .array(ReleaseRefSchema)
68
+ .describe('Releases (editions) in this group (may be empty).'),
69
+ tags: z.array(TagSchema).describe('Community tags/genres (may be empty).'),
70
+ coverArt: CoverArtStubSchema.describe('Whether cover art exists (availability stub from WS/2).'),
71
+ }),
72
+ async handler(input, ctx) {
73
+ ctx.log.info('musicbrainz_get_release_group', { mbid: input.mbid });
74
+ const service = getMusicBrainzService();
75
+ let raw;
76
+ try {
77
+ raw = await service.lookup('release-group', input.mbid, { inc: ['releases', 'artist-credits', 'tags', 'genres'] }, ctx, { signal: ctx.signal });
78
+ }
79
+ catch (error) {
80
+ const reason = classifyMbidError(error);
81
+ if (reason)
82
+ throw ctx.fail(reason, undefined, { ...ctx.recoveryFor(reason), mbid: input.mbid });
83
+ throw error;
84
+ }
85
+ const credits = normalizeArtistCredits(raw['artist-credit']);
86
+ const releases = (raw.releases ?? []).map((r) => ({
87
+ mbid: r.id,
88
+ title: r.title ?? '',
89
+ ...(r.date ? { date: r.date } : {}),
90
+ ...(r.country ? { country: r.country } : {}),
91
+ ...(r.status ? { status: r.status } : {}),
92
+ ...(r.disambiguation ? { disambiguation: r.disambiguation } : {}),
93
+ }));
94
+ return {
95
+ mbid: raw.id,
96
+ title: raw.title ?? '',
97
+ ...(raw.disambiguation ? { disambiguation: raw.disambiguation } : {}),
98
+ ...(raw['primary-type'] ? { primaryType: raw['primary-type'] } : {}),
99
+ ...(raw['secondary-types']?.length ? { secondaryTypes: raw['secondary-types'] } : {}),
100
+ ...(raw['first-release-date'] ? { firstReleaseDate: raw['first-release-date'] } : {}),
101
+ artistCredit: credits,
102
+ artistCreditString: artistCreditString(credits),
103
+ releases,
104
+ tags: normalizeTags(raw.tags ?? raw.genres),
105
+ coverArt: normalizeCoverArtStub(raw['cover-art-archive']),
106
+ };
107
+ },
108
+ format: (result) => {
109
+ const lines = [
110
+ `## ${safeText(result.title)}${result.disambiguation ? ` (${safeText(result.disambiguation)})` : ''}`,
111
+ ];
112
+ lines.push(`**MBID:** ${result.mbid}`);
113
+ lines.push(`**Artist:** ${safeText(result.artistCreditString)}`);
114
+ const types = [result.primaryType, ...(result.secondaryTypes ?? [])]
115
+ .filter(Boolean)
116
+ .map((t) => safeText(t))
117
+ .join(', ');
118
+ if (types)
119
+ lines.push(`**Type:** ${types}`);
120
+ if (result.firstReleaseDate)
121
+ lines.push(`**First release:** ${result.firstReleaseDate}`);
122
+ lines.push(renderCoverArtStub(result.coverArt));
123
+ const tags = renderTags(result.tags);
124
+ if (tags)
125
+ lines.push(tags);
126
+ lines.push(...renderArtistCredits(result.artistCredit));
127
+ if (result.releases.length) {
128
+ lines.push('', `### Releases (${result.releases.length})`);
129
+ for (const r of result.releases) {
130
+ const meta = [r.date, r.country, r.status ? safeText(r.status) : null]
131
+ .filter(Boolean)
132
+ .join(', ');
133
+ const dis = r.disambiguation ? ` [${safeText(r.disambiguation)}]` : '';
134
+ lines.push(`- **${safeText(r.title)}**${dis}${meta ? ` (${meta})` : ''} — ${r.mbid}`);
135
+ }
136
+ }
137
+ return [{ type: 'text', text: lines.join('\n') }];
138
+ },
139
+ });
140
+ //# sourceMappingURL=get-release-group.tool.js.map
@@ -0,0 +1 @@
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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"}
@@ -0,0 +1,66 @@
1
+ /**
2
+ * @fileoverview musicbrainz_get_release — one edition's full detail by MBID:
3
+ * tracklist (media → tracks → recordings with lengths and MBIDs), label + catalog
4
+ * number, barcode, country, release date, format, packaging, text representation,
5
+ * and a cover-art availability stub.
6
+ * @module mcp-server/tools/definitions/get-release.tool
7
+ */
8
+ import { z } from '@cyanheads/mcp-ts-core';
9
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
10
+ export declare const getReleaseTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
11
+ mbid: z.ZodString;
12
+ }, z.core.$strip>, z.ZodObject<{
13
+ mbid: z.ZodString;
14
+ title: z.ZodString;
15
+ disambiguation: z.ZodOptional<z.ZodString>;
16
+ artistCredit: z.ZodArray<z.ZodObject<{
17
+ name: z.ZodString;
18
+ artistId: z.ZodString;
19
+ artistName: z.ZodString;
20
+ joinPhrase: z.ZodOptional<z.ZodString>;
21
+ }, z.core.$strip>>;
22
+ artistCreditString: z.ZodString;
23
+ status: z.ZodOptional<z.ZodString>;
24
+ date: z.ZodOptional<z.ZodString>;
25
+ country: z.ZodOptional<z.ZodString>;
26
+ barcode: z.ZodOptional<z.ZodString>;
27
+ packaging: z.ZodOptional<z.ZodString>;
28
+ language: z.ZodOptional<z.ZodString>;
29
+ script: z.ZodOptional<z.ZodString>;
30
+ releaseGroupId: z.ZodOptional<z.ZodString>;
31
+ labelInfo: z.ZodArray<z.ZodObject<{
32
+ labelId: z.ZodOptional<z.ZodString>;
33
+ labelName: z.ZodOptional<z.ZodString>;
34
+ catalogNumber: z.ZodOptional<z.ZodString>;
35
+ }, z.core.$strip>>;
36
+ media: z.ZodArray<z.ZodObject<{
37
+ position: z.ZodOptional<z.ZodNumber>;
38
+ format: z.ZodOptional<z.ZodString>;
39
+ title: z.ZodOptional<z.ZodString>;
40
+ trackCount: z.ZodOptional<z.ZodNumber>;
41
+ tracks: z.ZodArray<z.ZodObject<{
42
+ position: z.ZodOptional<z.ZodNumber>;
43
+ number: z.ZodOptional<z.ZodString>;
44
+ title: z.ZodString;
45
+ length: z.ZodOptional<z.ZodString>;
46
+ recordingId: z.ZodOptional<z.ZodString>;
47
+ }, z.core.$strip>>;
48
+ }, z.core.$strip>>;
49
+ coverArt: z.ZodObject<{
50
+ exists: z.ZodBoolean;
51
+ count: z.ZodOptional<z.ZodNumber>;
52
+ front: z.ZodOptional<z.ZodBoolean>;
53
+ back: z.ZodOptional<z.ZodBoolean>;
54
+ }, z.core.$strip>;
55
+ }, z.core.$strip>, readonly [{
56
+ readonly reason: "invalid_mbid";
57
+ readonly code: JsonRpcErrorCode.InvalidParams;
58
+ readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).";
59
+ readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entity_type=release) to find one from a title.";
60
+ }, {
61
+ readonly reason: "entity_not_found";
62
+ readonly code: JsonRpcErrorCode.NotFound;
63
+ readonly when: "The MBID is well-formed but no release exists with it (MusicBrainz returns HTTP 404).";
64
+ readonly recovery: "No release exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.";
65
+ }], undefined>;
66
+ //# sourceMappingURL=get-release.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-release.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-release.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAqEjE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkLzB,CAAC"}
@@ -0,0 +1,213 @@
1
+ /**
2
+ * @fileoverview musicbrainz_get_release — one edition's full detail by MBID:
3
+ * tracklist (media → tracks → recordings with lengths and MBIDs), label + catalog
4
+ * number, barcode, country, release date, format, packaging, text representation,
5
+ * and a cover-art availability stub.
6
+ * @module mcp-server/tools/definitions/get-release.tool
7
+ */
8
+ import { tool, z } from '@cyanheads/mcp-ts-core';
9
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
10
+ import { getMusicBrainzService } from '../../../services/musicbrainz/musicbrainz-service.js';
11
+ import { ArtistCreditSchema, artistCreditString, CoverArtStubSchema, classifyMbidError, formatDuration, MBID_EXAMPLE, normalizeArtistCredits, normalizeCoverArtStub, renderArtistCredits, renderCoverArtStub, safeText, } from './_shared.js';
12
+ const TrackSchema = z
13
+ .object({
14
+ position: z.number().optional().describe('Track position on the medium. Omitted when absent.'),
15
+ number: z
16
+ .string()
17
+ .optional()
18
+ .describe('Printed track number (may differ from position). Omitted when absent.'),
19
+ title: z.string().describe('Track title.'),
20
+ length: z.string().optional().describe('Track length as m:ss. Omitted when unknown.'),
21
+ recordingId: z
22
+ .string()
23
+ .optional()
24
+ .describe('Recording MBID — chain to musicbrainz_get_recording. Omitted when absent.'),
25
+ })
26
+ .describe('A track on a medium, linked to its underlying recording.');
27
+ const MediumSchema = z
28
+ .object({
29
+ position: z
30
+ .number()
31
+ .optional()
32
+ .describe('Medium position in the release (disc 1, 2, …). Omitted when absent.'),
33
+ format: z
34
+ .string()
35
+ .optional()
36
+ .describe('Medium format (CD, Vinyl, Digital Media, …). Omitted when unknown.'),
37
+ title: z
38
+ .string()
39
+ .optional()
40
+ .describe('Medium title, when the disc is named. Omitted when absent.'),
41
+ trackCount: z
42
+ .number()
43
+ .optional()
44
+ .describe('Number of tracks on the medium. Omitted when absent.'),
45
+ tracks: z.array(TrackSchema).describe('Tracks on this medium (may be empty).'),
46
+ })
47
+ .describe('One physical/digital medium (disc) of the release.');
48
+ const LabelInfoSchema = z
49
+ .object({
50
+ labelId: z
51
+ .string()
52
+ .optional()
53
+ .describe('Label MBID — chain to musicbrainz_get_label. Omitted when absent.'),
54
+ labelName: z.string().optional().describe('Label name. Omitted when absent.'),
55
+ catalogNumber: z
56
+ .string()
57
+ .optional()
58
+ .describe('Catalog number on this release. Omitted when absent.'),
59
+ })
60
+ .describe('Label + catalog-number pairing for the release.');
61
+ export const getReleaseTool = tool('musicbrainz_get_release', {
62
+ title: 'musicbrainz-mcp-server: get release',
63
+ description: "One edition's full detail by MBID: the tracklist (media → tracks → recordings with lengths and recording MBIDs), label + catalog number, barcode, country, release date, format, packaging, text representation (language/script), and a cover-art availability stub. Track lengths are rendered m:ss (stored as milliseconds upstream). For the actual cover image URLs, call musicbrainz_get_cover_art with this release MBID.",
64
+ annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
65
+ errors: [
66
+ {
67
+ reason: 'invalid_mbid',
68
+ code: JsonRpcErrorCode.InvalidParams,
69
+ when: 'The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).',
70
+ recovery: `MBID must be a 36-character UUID (e.g. ${MBID_EXAMPLE}). Use musicbrainz_search_entities (entity_type=release) to find one from a title.`,
71
+ },
72
+ {
73
+ reason: 'entity_not_found',
74
+ code: JsonRpcErrorCode.NotFound,
75
+ when: 'The MBID is well-formed but no release exists with it (MusicBrainz returns HTTP 404).',
76
+ recovery: 'No release exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.',
77
+ },
78
+ ],
79
+ input: z.object({
80
+ mbid: z.string().describe('Release MBID (36-character UUID).'),
81
+ }),
82
+ output: z.object({
83
+ mbid: z.string().describe('Release MBID.'),
84
+ title: z.string().describe('Release title.'),
85
+ disambiguation: z.string().optional().describe('Short qualifier. Omitted when absent.'),
86
+ artistCredit: z.array(ArtistCreditSchema).describe('Credited artists (may be empty).'),
87
+ artistCreditString: z
88
+ .string()
89
+ .describe('Display string of the artist credit with join phrases.'),
90
+ status: z
91
+ .string()
92
+ .optional()
93
+ .describe('Release status (Official, Promotion, Bootleg, …). Omitted when absent.'),
94
+ date: z.string().optional().describe('Release date. Omitted when absent.'),
95
+ country: z.string().optional().describe('Release country code. Omitted when absent.'),
96
+ barcode: z
97
+ .string()
98
+ .optional()
99
+ .describe('Barcode (UPC/EAN). Omitted when absent; empty string upstream means "known to have none".'),
100
+ packaging: z
101
+ .string()
102
+ .optional()
103
+ .describe('Packaging type (Jewel Case, Digipak, …). Omitted when absent.'),
104
+ language: z
105
+ .string()
106
+ .optional()
107
+ .describe('Text-representation language code. Omitted when absent.'),
108
+ script: z.string().optional().describe('Text-representation script code. Omitted when absent.'),
109
+ releaseGroupId: z
110
+ .string()
111
+ .optional()
112
+ .describe('Parent release-group MBID — chain to musicbrainz_get_release_group. Omitted when absent.'),
113
+ labelInfo: z.array(LabelInfoSchema).describe('Label / catalog-number pairings (may be empty).'),
114
+ media: z.array(MediumSchema).describe('Media (discs) with their tracklists (may be empty).'),
115
+ coverArt: CoverArtStubSchema.describe('Whether cover art exists (availability stub from WS/2).'),
116
+ }),
117
+ async handler(input, ctx) {
118
+ ctx.log.info('musicbrainz_get_release', { mbid: input.mbid });
119
+ const service = getMusicBrainzService();
120
+ let raw;
121
+ try {
122
+ raw = await service.lookup('release', input.mbid, { inc: ['recordings', 'artist-credits', 'labels', 'release-groups'] }, ctx, { signal: ctx.signal });
123
+ }
124
+ catch (error) {
125
+ const reason = classifyMbidError(error);
126
+ if (reason)
127
+ throw ctx.fail(reason, undefined, { ...ctx.recoveryFor(reason), mbid: input.mbid });
128
+ throw error;
129
+ }
130
+ const credits = normalizeArtistCredits(raw['artist-credit']);
131
+ const media = (raw.media ?? []).map((m) => ({
132
+ ...(typeof m.position === 'number' ? { position: m.position } : {}),
133
+ ...(m.format ? { format: m.format } : {}),
134
+ ...(m.title ? { title: m.title } : {}),
135
+ ...(typeof m['track-count'] === 'number' ? { trackCount: m['track-count'] } : {}),
136
+ tracks: (m.tracks ?? []).map((t) => {
137
+ const length = formatDuration(t.length ?? t.recording?.length);
138
+ return {
139
+ ...(typeof t.position === 'number' ? { position: t.position } : {}),
140
+ ...(t.number ? { number: t.number } : {}),
141
+ title: t.title ?? t.recording?.title ?? '',
142
+ ...(length ? { length } : {}),
143
+ ...(t.recording?.id ? { recordingId: t.recording.id } : {}),
144
+ };
145
+ }),
146
+ }));
147
+ const labelInfo = (raw['label-info'] ?? []).map((li) => ({
148
+ ...(li.label?.id ? { labelId: li.label.id } : {}),
149
+ ...(li.label?.name ? { labelName: li.label.name } : {}),
150
+ ...(li['catalog-number'] ? { catalogNumber: li['catalog-number'] } : {}),
151
+ }));
152
+ return {
153
+ mbid: raw.id,
154
+ title: raw.title ?? '',
155
+ ...(raw.disambiguation ? { disambiguation: raw.disambiguation } : {}),
156
+ artistCredit: credits,
157
+ artistCreditString: artistCreditString(credits),
158
+ ...(raw.status ? { status: raw.status } : {}),
159
+ ...(raw.date ? { date: raw.date } : {}),
160
+ ...(raw.country ? { country: raw.country } : {}),
161
+ ...(raw.barcode ? { barcode: raw.barcode } : {}),
162
+ ...(raw.packaging ? { packaging: raw.packaging } : {}),
163
+ ...(raw['text-representation']?.language
164
+ ? { language: raw['text-representation'].language }
165
+ : {}),
166
+ ...(raw['text-representation']?.script ? { script: raw['text-representation'].script } : {}),
167
+ ...(raw['release-group']?.id ? { releaseGroupId: raw['release-group'].id } : {}),
168
+ labelInfo,
169
+ media,
170
+ coverArt: normalizeCoverArtStub(raw['cover-art-archive']),
171
+ };
172
+ },
173
+ format: (result) => {
174
+ const lines = [
175
+ `## ${safeText(result.title)}${result.disambiguation ? ` (${safeText(result.disambiguation)})` : ''}`,
176
+ ];
177
+ lines.push(`**MBID:** ${result.mbid}`);
178
+ lines.push(`**Artist:** ${safeText(result.artistCreditString)}`);
179
+ if (result.status)
180
+ lines.push(`**Status:** ${safeText(result.status)}`);
181
+ if (result.date)
182
+ lines.push(`**Date:** ${result.date}`);
183
+ if (result.country)
184
+ lines.push(`**Country:** ${result.country}`);
185
+ if (result.barcode)
186
+ lines.push(`**Barcode:** ${safeText(result.barcode)}`);
187
+ if (result.packaging)
188
+ lines.push(`**Packaging:** ${safeText(result.packaging)}`);
189
+ if (result.language || result.script) {
190
+ lines.push(`**Text:** ${[result.language, result.script].filter(Boolean).join(' / ')}`);
191
+ }
192
+ if (result.releaseGroupId)
193
+ lines.push(`**Release group:** ${result.releaseGroupId}`);
194
+ lines.push(renderCoverArtStub(result.coverArt));
195
+ if (result.labelInfo.length) {
196
+ lines.push(`**Labels:** ${result.labelInfo
197
+ .map((li) => `${li.labelName ? safeText(li.labelName) : '?'}${li.labelId ? ` (${li.labelId})` : ''}${li.catalogNumber ? ` cat# ${safeText(li.catalogNumber)}` : ''}`)
198
+ .join(', ')}`);
199
+ }
200
+ lines.push(...renderArtistCredits(result.artistCredit));
201
+ for (const m of result.media) {
202
+ const trackCount = typeof m.trackCount === 'number' ? ` (${m.trackCount} tracks)` : '';
203
+ lines.push('', `### Medium ${m.position ?? ''}${m.format ? ` — ${safeText(m.format)}` : ''}${m.title ? ` "${safeText(m.title)}"` : ''}${trackCount}`.trim());
204
+ for (const t of m.tracks) {
205
+ const posLabel = typeof t.position === 'number' ? `#${t.position}` : '';
206
+ const num = t.number && t.number !== String(t.position) ? ` (printed ${safeText(t.number)})` : '';
207
+ lines.push(`${posLabel || (t.number ? safeText(t.number) : '?')}${num}. ${safeText(t.title)}${t.length ? ` (${t.length})` : ''}${t.recordingId ? ` — ${t.recordingId}` : ''}`);
208
+ }
209
+ }
210
+ return [{ type: 'text', text: lines.join('\n') }];
211
+ },
212
+ });
213
+ //# sourceMappingURL=get-release.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-release.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-release.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ /**
2
+ * @fileoverview musicbrainz_get_work — work (a composition, the song as written,
3
+ * distinct from any recording) by MBID: type, language(s), ISWCs, writer/composer/
4
+ * lyricist relationships, and the recordings that perform it. Recording relations
5
+ * are capped at one page — musicbrainz_browse_entities (recording by work) gives
6
+ * the complete list.
7
+ * @module mcp-server/tools/definitions/get-work.tool
8
+ */
9
+ import { z } from '@cyanheads/mcp-ts-core';
10
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
11
+ export declare const getWorkTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
12
+ mbid: z.ZodString;
13
+ inc_relationships: z.ZodDefault<z.ZodBoolean>;
14
+ }, z.core.$strip>, z.ZodObject<{
15
+ mbid: z.ZodString;
16
+ title: z.ZodString;
17
+ disambiguation: z.ZodOptional<z.ZodString>;
18
+ type: z.ZodOptional<z.ZodString>;
19
+ languages: z.ZodArray<z.ZodString>;
20
+ iswcs: z.ZodArray<z.ZodString>;
21
+ aliases: z.ZodArray<z.ZodObject<{
22
+ name: z.ZodString;
23
+ sortName: z.ZodOptional<z.ZodString>;
24
+ type: z.ZodOptional<z.ZodString>;
25
+ locale: z.ZodOptional<z.ZodString>;
26
+ primary: z.ZodOptional<z.ZodBoolean>;
27
+ }, z.core.$strip>>;
28
+ tags: z.ZodArray<z.ZodObject<{
29
+ name: z.ZodString;
30
+ count: z.ZodNumber;
31
+ }, z.core.$strip>>;
32
+ relationships: z.ZodArray<z.ZodObject<{
33
+ type: z.ZodString;
34
+ direction: z.ZodOptional<z.ZodString>;
35
+ attributes: z.ZodOptional<z.ZodArray<z.ZodString>>;
36
+ targetType: z.ZodString;
37
+ targetId: z.ZodOptional<z.ZodString>;
38
+ targetName: z.ZodOptional<z.ZodString>;
39
+ begin: z.ZodOptional<z.ZodString>;
40
+ end: z.ZodOptional<z.ZodString>;
41
+ }, z.core.$strip>>;
42
+ externalLinks: z.ZodArray<z.ZodObject<{
43
+ type: z.ZodString;
44
+ resource: z.ZodString;
45
+ }, z.core.$strip>>;
46
+ }, z.core.$strip>, readonly [{
47
+ readonly reason: "invalid_mbid";
48
+ readonly code: JsonRpcErrorCode.InvalidParams;
49
+ readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).";
50
+ readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entity_type=work) to find one from a title.";
51
+ }, {
52
+ readonly reason: "entity_not_found";
53
+ readonly code: JsonRpcErrorCode.NotFound;
54
+ readonly when: "The MBID is well-formed but no work exists with it (MusicBrainz returns HTTP 404).";
55
+ readonly recovery: "No work exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.";
56
+ }], {
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=get-work.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-work.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-work.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAuBjE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkItB,CAAC"}