@cyanheads/musicbrainz-mcp-server 0.2.1 → 0.4.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 (71) hide show
  1. package/AGENTS.md +36 -10
  2. package/CLAUDE.md +36 -10
  3. package/Dockerfile +3 -0
  4. package/README.md +49 -108
  5. package/changelog/0.3.x/0.3.0.md +33 -0
  6. package/changelog/0.4.x/0.4.0.md +31 -0
  7. package/changelog/template.md +10 -3
  8. package/dist/index.js +2 -1
  9. package/dist/index.js.map +1 -1
  10. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -1
  11. package/dist/mcp-server/resources/definitions/entity.resource.js +32 -6
  12. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
  13. package/dist/mcp-server/tools/definitions/_pagination.d.ts +1 -1
  14. package/dist/mcp-server/tools/definitions/_pagination.d.ts.map +1 -1
  15. package/dist/mcp-server/tools/definitions/_pagination.js +7 -1
  16. package/dist/mcp-server/tools/definitions/_pagination.js.map +1 -1
  17. package/dist/mcp-server/tools/definitions/_shared.d.ts +2 -2
  18. package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -1
  19. package/dist/mcp-server/tools/definitions/_shared.js +13 -9
  20. package/dist/mcp-server/tools/definitions/_shared.js.map +1 -1
  21. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +33 -2
  22. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
  23. package/dist/mcp-server/tools/definitions/browse-entities.tool.js +120 -9
  24. package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
  25. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +40 -3
  26. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -1
  27. package/dist/mcp-server/tools/definitions/get-artist.tool.js +145 -6
  28. package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -1
  29. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +15 -0
  30. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -1
  31. package/dist/mcp-server/tools/definitions/get-label.tool.js +28 -4
  32. package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -1
  33. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -1
  34. package/dist/mcp-server/tools/definitions/get-recording.tool.js +5 -5
  35. package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -1
  36. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +4 -0
  37. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -1
  38. package/dist/mcp-server/tools/definitions/get-release-group.tool.js +9 -3
  39. package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -1
  40. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +27 -0
  41. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -1
  42. package/dist/mcp-server/tools/definitions/get-release.tool.js +51 -27
  43. package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
  44. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +5 -1
  45. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -1
  46. package/dist/mcp-server/tools/definitions/get-work.tool.js +32 -4
  47. package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
  48. package/dist/mcp-server/tools/definitions/index.d.ts +168 -3
  49. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  50. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +18 -1
  51. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -1
  52. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +27 -3
  53. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -1
  54. package/dist/mcp-server/tools/definitions/release-edition.d.ts +44 -0
  55. package/dist/mcp-server/tools/definitions/release-edition.d.ts.map +1 -0
  56. package/dist/mcp-server/tools/definitions/release-edition.js +143 -0
  57. package/dist/mcp-server/tools/definitions/release-edition.js.map +1 -0
  58. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +30 -1
  59. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -1
  60. package/dist/mcp-server/tools/definitions/search-entities.tool.js +115 -24
  61. package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
  62. package/dist/services/musicbrainz/musicbrainz-service.d.ts +20 -3
  63. package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
  64. package/dist/services/musicbrainz/musicbrainz-service.js +12 -1
  65. package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
  66. package/dist/services/musicbrainz/types.d.ts +40 -3
  67. package/dist/services/musicbrainz/types.d.ts.map +1 -1
  68. package/package.json +9 -8
  69. package/server.json +3 -3
  70. package/skills/musicbrainz-guide/SKILL.md +72 -0
  71. package/skills/musicbrainz-guide/references/query-syntax.md +24 -0
@@ -0,0 +1,143 @@
1
+ /**
2
+ * @fileoverview Shared release-edition metadata for discovery rows and release detail.
3
+ * @module mcp-server/tools/definitions/release-edition
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ import { safeText } from './_shared.js';
7
+ export const LabelInfoSchema = z
8
+ .object({
9
+ labelId: z
10
+ .string()
11
+ .optional()
12
+ .describe('Label MBID — chain to musicbrainz_get_label. Omitted when absent.'),
13
+ labelName: z.string().optional().describe('Label name. Omitted when absent.'),
14
+ catalogNumber: z
15
+ .string()
16
+ .optional()
17
+ .describe('Catalog number on this release. Omitted when absent.'),
18
+ })
19
+ .describe('Label + catalog-number pairing for the release.');
20
+ export const ReleaseEventSchema = z
21
+ .object({
22
+ date: z.string().optional().describe('Event date, which may be partial. Omitted when unknown.'),
23
+ country: z
24
+ .string()
25
+ .optional()
26
+ .describe('ISO 3166-1 code of the event area. Omitted when unknown.'),
27
+ })
28
+ .describe('One dated or country-specific release event.');
29
+ export const ReleaseEditionSchema = z.object({
30
+ labelInfo: z
31
+ .array(LabelInfoSchema)
32
+ .optional()
33
+ .describe('Known label and catalog-number pairings. Omitted when none are known.'),
34
+ formats: z
35
+ .array(z.string())
36
+ .optional()
37
+ .describe('Known media formats in medium order. Omitted when none are known.'),
38
+ trackCount: z
39
+ .number()
40
+ .optional()
41
+ .describe('Reported release track count, or sum of all medium counts. Omitted when unknown.'),
42
+ barcode: z
43
+ .string()
44
+ .optional()
45
+ .describe('UPC/EAN. Empty means confirmed absent. Omitted when unknown.'),
46
+ packaging: z.string().optional().describe('Packaging type. Omitted when unknown.'),
47
+ releaseGroupId: z
48
+ .string()
49
+ .optional()
50
+ .describe('Parent release-group MBID — chain to musicbrainz_get_release_group.'),
51
+ releaseEvents: z
52
+ .array(ReleaseEventSchema)
53
+ .optional()
54
+ .describe('Release dates and countries in upstream event order. Omitted when none are known.'),
55
+ });
56
+ /** Normalize each label row, retaining independently known names, IDs, and catalog numbers. */
57
+ export function mapLabelInfo(raw) {
58
+ return (raw['label-info'] ?? []).map((li) => ({
59
+ ...(li.label?.id ? { labelId: li.label.id } : {}),
60
+ ...(li.label?.name ? { labelName: li.label.name } : {}),
61
+ ...(li['catalog-number'] ? { catalogNumber: li['catalog-number'] } : {}),
62
+ }));
63
+ }
64
+ /** Read each event's own date and country without falling back to the release scalars. */
65
+ export function mapReleaseEvents(raw) {
66
+ const events = [];
67
+ for (const event of raw['release-events'] ?? []) {
68
+ const country = event.area?.['iso-3166-1-codes']?.[0];
69
+ if (!event.date && !country)
70
+ continue;
71
+ events.push({
72
+ ...(event.date ? { date: event.date } : {}),
73
+ ...(country ? { country } : {}),
74
+ });
75
+ }
76
+ return events;
77
+ }
78
+ /** Project edition fields shared by release search, browse, and barcode lookup. */
79
+ export function mapReleaseEdition(raw) {
80
+ const labelInfo = mapLabelInfo(raw).filter((li) => li.labelId || li.labelName || li.catalogNumber);
81
+ const releaseEvents = mapReleaseEvents(raw);
82
+ const media = raw.media ?? [];
83
+ const formats = media
84
+ .map((medium) => medium.format)
85
+ .filter((format) => Boolean(format));
86
+ const counts = media.map((medium) => medium['track-count']);
87
+ const trackCount = typeof raw['track-count'] === 'number'
88
+ ? raw['track-count']
89
+ : counts.length > 0 && counts.every((count) => typeof count === 'number')
90
+ ? counts.reduce((sum, count) => sum + count, 0)
91
+ : undefined;
92
+ return {
93
+ ...(labelInfo.length ? { labelInfo } : {}),
94
+ ...(formats.length ? { formats } : {}),
95
+ ...(trackCount === undefined ? {} : { trackCount }),
96
+ ...(typeof raw.barcode === 'string' ? { barcode: raw.barcode } : {}),
97
+ ...(raw.packaging ? { packaging: raw.packaging } : {}),
98
+ ...(raw['release-group']?.id ? { releaseGroupId: raw['release-group'].id } : {}),
99
+ ...(releaseEvents.length ? { releaseEvents } : {}),
100
+ };
101
+ }
102
+ /** Render partial label rows, with a placeholder in the release detail view. */
103
+ export function renderLabelInfo(labelInfo, missingName) {
104
+ const labels = labelInfo.map((li) => {
105
+ const name = li.labelName ? safeText(li.labelName) : missingName;
106
+ const label = name === undefined ? li.labelId : `${name}${li.labelId ? ` (${li.labelId})` : ''}`;
107
+ const catalogNumber = li.catalogNumber ? `cat# ${safeText(li.catalogNumber)}` : undefined;
108
+ const parts = [label, catalogNumber];
109
+ return (missingName ? parts.filter((part) => part !== undefined) : parts.filter(Boolean)).join(' ');
110
+ });
111
+ return (missingName ? labels : labels.filter(Boolean)).join(', ');
112
+ }
113
+ /** Render known dates and countries from ordered release events. */
114
+ export function renderReleaseEvents(events) {
115
+ return events
116
+ .map(({ date, country }) => date && country
117
+ ? `${safeText(date)} (${safeText(country)})`
118
+ : safeText(date ?? country ?? ''))
119
+ .join(', ');
120
+ }
121
+ /** Render pressing metadata as nested rows underneath a discovery hit. */
122
+ export function renderReleaseEdition(edition) {
123
+ const lines = [];
124
+ if (edition.labelInfo?.length) {
125
+ lines.push(` - **Labels:** ${renderLabelInfo(edition.labelInfo)}`);
126
+ }
127
+ if (edition.formats?.length)
128
+ lines.push(` - **Formats:** ${edition.formats.map(safeText).join(', ')}`);
129
+ if (edition.trackCount !== undefined)
130
+ lines.push(` - **Track count:** ${edition.trackCount}`);
131
+ if (edition.barcode !== undefined) {
132
+ lines.push(` - **Barcode:** ${edition.barcode === '' ? 'None (confirmed)' : safeText(edition.barcode)}`);
133
+ }
134
+ if (edition.packaging)
135
+ lines.push(` - **Packaging:** ${safeText(edition.packaging)}`);
136
+ if (edition.releaseGroupId)
137
+ lines.push(` - **Release group:** ${edition.releaseGroupId}`);
138
+ if (edition.releaseEvents?.length) {
139
+ lines.push(` - **Release events:** ${renderReleaseEvents(edition.releaseEvents)}`);
140
+ }
141
+ return lines;
142
+ }
143
+ //# sourceMappingURL=release-edition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"release-edition.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/release-edition.ts"],"names":[],"mappings":"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"}
@@ -3,13 +3,14 @@
3
3
  * MusicBrainz entity type, returning ranked lightweight matches (MBID, name,
4
4
  * disambiguation, type, 0–100 relevance score). The required first step when
5
5
  * starting from a name rather than an MBID; chain the returned MBID into the
6
- * matching get_* tool.
6
+ * matching get_* tool or use an area MBID as a browse parent.
7
7
  * @module mcp-server/tools/definitions/search-entities.tool
8
8
  */
9
9
  import { z } from '@cyanheads/mcp-ts-core';
10
10
  import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
11
11
  export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
12
12
  entityType: z.ZodEnum<{
13
+ area: "area";
13
14
  artist: "artist";
14
15
  label: "label";
15
16
  recording: "recording";
@@ -24,6 +25,20 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
24
25
  entityType: z.ZodString;
25
26
  offset: z.ZodNumber;
26
27
  results: z.ZodArray<z.ZodObject<{
28
+ labelInfo: z.ZodOptional<z.ZodArray<z.ZodObject<{
29
+ labelId: z.ZodOptional<z.ZodString>;
30
+ labelName: z.ZodOptional<z.ZodString>;
31
+ catalogNumber: z.ZodOptional<z.ZodString>;
32
+ }, z.core.$strip>>>;
33
+ formats: z.ZodOptional<z.ZodArray<z.ZodString>>;
34
+ trackCount: z.ZodOptional<z.ZodNumber>;
35
+ barcode: z.ZodOptional<z.ZodString>;
36
+ packaging: z.ZodOptional<z.ZodString>;
37
+ releaseGroupId: z.ZodOptional<z.ZodString>;
38
+ releaseEvents: z.ZodOptional<z.ZodArray<z.ZodObject<{
39
+ date: z.ZodOptional<z.ZodString>;
40
+ country: z.ZodOptional<z.ZodString>;
41
+ }, z.core.$strip>>>;
27
42
  mbid: z.ZodString;
28
43
  name: z.ZodString;
29
44
  score: z.ZodNumber;
@@ -36,8 +51,22 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
36
51
  length: z.ZodOptional<z.ZodString>;
37
52
  isrcs: z.ZodOptional<z.ZodArray<z.ZodString>>;
38
53
  iswcs: z.ZodOptional<z.ZodArray<z.ZodString>>;
54
+ secondaryTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
55
+ firstReleaseDate: z.ZodOptional<z.ZodString>;
56
+ iso3166_1: z.ZodOptional<z.ZodArray<z.ZodString>>;
57
+ iso3166_2: z.ZodOptional<z.ZodArray<z.ZodString>>;
58
+ iso3166_3: z.ZodOptional<z.ZodArray<z.ZodString>>;
59
+ partOf: z.ZodOptional<z.ZodArray<z.ZodObject<{
60
+ mbid: z.ZodString;
61
+ name: z.ZodString;
62
+ }, z.core.$strip>>>;
39
63
  }, z.core.$strip>>;
40
64
  }, z.core.$strip>, readonly [{
65
+ readonly reason: "search_window_exceeded";
66
+ readonly code: JsonRpcErrorCode.ValidationError;
67
+ readonly when: "The offset is at or beyond the 500-match search window.";
68
+ readonly recovery: "Use an offset below 500 and narrow the query, or use musicbrainz_browse_entities for complete linked sets.";
69
+ }, {
41
70
  readonly reason: "blank_query";
42
71
  readonly code: JsonRpcErrorCode.ValidationError;
43
72
  readonly when: "The query contains only whitespace (it is blank after trimming).";
@@ -1 +1 @@
1
- {"version":3,"file":"search-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsIjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6G7B,CAAC"}
1
+ {"version":3,"file":"search-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAyNjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkJ7B,CAAC"}
@@ -3,7 +3,7 @@
3
3
  * MusicBrainz entity type, returning ranked lightweight matches (MBID, name,
4
4
  * disambiguation, type, 0–100 relevance score). The required first step when
5
5
  * starting from a name rather than an MBID; chain the returned MBID into the
6
- * matching get_* tool.
6
+ * matching get_* tool or use an area MBID as a browse parent.
7
7
  * @module mcp-server/tools/definitions/search-entities.tool
8
8
  */
9
9
  import { tool, z } from '@cyanheads/mcp-ts-core';
@@ -11,15 +11,24 @@ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
11
11
  import { getMusicBrainzService, MusicBrainzService, } from '../../../services/musicbrainz/musicbrainz-service.js';
12
12
  import { applyPageLimit, PageLimit, pageNotice } from './_pagination.js';
13
13
  import { artistCreditString, formatDuration, normalizeArtistCredits, safeText } from './_shared.js';
14
- const ENTITY_TYPES = ['artist', 'release-group', 'release', 'recording', 'work', 'label'];
14
+ import { mapReleaseEdition, ReleaseEditionSchema, renderReleaseEdition, } from './release-edition.js';
15
+ const ENTITY_TYPES = [
16
+ 'artist',
17
+ 'release-group',
18
+ 'release',
19
+ 'recording',
20
+ 'work',
21
+ 'label',
22
+ 'area',
23
+ ];
15
24
  const ResultSchema = z
16
25
  .object({
17
26
  mbid: z
18
27
  .string()
19
- .describe('MusicBrainz identifier (UUID) — chain into the matching musicbrainz_get_* tool.'),
28
+ .describe('MusicBrainz identifier (UUID). Use an area MBID for musicbrainz_browse_entities link.area; otherwise use the matching musicbrainz_get_* tool.'),
20
29
  name: z
21
30
  .string()
22
- .describe('Entity name (artist/label) or title (release-group/release/recording/work).'),
31
+ .describe('Entity name (artist/label/area) or title (release-group/release/recording/work).'),
23
32
  score: z
24
33
  .number()
25
34
  .describe('Lucene relevance score, 0–100. 100 = exact match; low scores are weak partial matches.'),
@@ -30,7 +39,7 @@ const ResultSchema = z
30
39
  type: z
31
40
  .string()
32
41
  .optional()
33
- .describe('Entity subtype (artist type, release-group primary type, work type, label type). Omitted when absent.'),
42
+ .describe('Entity subtype (artist, work, label or area type, or release-group primary type). Omitted when absent.'),
34
43
  artistCredit: z
35
44
  .string()
36
45
  .optional()
@@ -53,19 +62,69 @@ const ResultSchema = z
53
62
  .optional()
54
63
  .describe('ISRCs on a recording result. Omitted when none.'),
55
64
  iswcs: z.array(z.string()).optional().describe('ISWCs on a work result. Omitted when none.'),
65
+ secondaryTypes: z
66
+ .array(z.string())
67
+ .optional()
68
+ .describe('Release-group secondary classifications, in upstream order. Omitted when empty; absence does not establish a studio album.'),
69
+ firstReleaseDate: z
70
+ .string()
71
+ .optional()
72
+ .describe('Recording first-release date, possibly partial. Omitted when absent.'),
73
+ iso3166_1: z
74
+ .array(z.string())
75
+ .optional()
76
+ .describe('ISO 3166-1 codes for an area in upstream order. Omitted when empty.'),
77
+ iso3166_2: z
78
+ .array(z.string())
79
+ .optional()
80
+ .describe('ISO 3166-2 subdivision codes for an area in upstream order. Omitted when empty.'),
81
+ iso3166_3: z
82
+ .array(z.string())
83
+ .optional()
84
+ .describe('ISO 3166-3 historical codes for an area in upstream order. Omitted when empty.'),
85
+ partOf: z
86
+ .array(z
87
+ .object({
88
+ mbid: z.string().describe('Immediate parent area MBID.'),
89
+ name: z.string().describe('Immediate parent area name.'),
90
+ })
91
+ .describe('An immediate parent area.'))
92
+ .optional()
93
+ .describe('Immediate parent areas reported by MusicBrainz, in upstream order. Omitted when none are available.'),
94
+ ...ReleaseEditionSchema.shape,
56
95
  })
57
96
  .describe('A ranked search hit. Type-specific fields appear only for the relevant entity type.');
58
97
  function mapHit(type, raw) {
59
98
  const base = raw;
60
- const score = typeof base.score === 'number' ? base.score : 0;
61
99
  const disambiguation = base.disambiguation?.trim();
100
+ const shared = {
101
+ mbid: base.id,
102
+ score: typeof base.score === 'number' ? base.score : 0,
103
+ ...(disambiguation ? { disambiguation } : {}),
104
+ };
105
+ if (type === 'area') {
106
+ const area = raw;
107
+ const partOf = (area['relation-list'] ?? []).flatMap(({ relations }) => (relations ?? []).flatMap((relation) => relation.type === 'part of' &&
108
+ relation.direction === 'backward' &&
109
+ relation.area?.id &&
110
+ relation.area.name
111
+ ? [{ mbid: relation.area.id, name: relation.area.name }]
112
+ : []));
113
+ return {
114
+ ...shared,
115
+ name: area.name ?? '',
116
+ ...(area.type ? { type: area.type } : {}),
117
+ ...(area['iso-3166-1-codes']?.length ? { iso3166_1: area['iso-3166-1-codes'] } : {}),
118
+ ...(area['iso-3166-2-codes']?.length ? { iso3166_2: area['iso-3166-2-codes'] } : {}),
119
+ ...(area['iso-3166-3-codes']?.length ? { iso3166_3: area['iso-3166-3-codes'] } : {}),
120
+ ...(partOf.length ? { partOf } : {}),
121
+ };
122
+ }
62
123
  if (type === 'artist' || type === 'label') {
63
124
  const e = raw;
64
125
  return {
65
- mbid: e.id,
126
+ ...shared,
66
127
  name: e.name ?? '',
67
- score,
68
- ...(disambiguation ? { disambiguation } : {}),
69
128
  ...(e.type ? { type: e.type } : {}),
70
129
  ...(e.country ? { country: e.country } : {}),
71
130
  };
@@ -73,10 +132,8 @@ function mapHit(type, raw) {
73
132
  if (type === 'work') {
74
133
  const e = raw;
75
134
  return {
76
- mbid: e.id,
135
+ ...shared,
77
136
  name: e.title ?? '',
78
- score,
79
- ...(disambiguation ? { disambiguation } : {}),
80
137
  ...(e.type ? { type: e.type } : {}),
81
138
  ...(e.iswcs?.length ? { iswcs: e.iswcs } : {}),
82
139
  };
@@ -85,13 +142,12 @@ function mapHit(type, raw) {
85
142
  const e = raw;
86
143
  const length = formatDuration(e.length);
87
144
  return {
88
- mbid: e.id,
145
+ ...shared,
89
146
  name: e.title ?? '',
90
- score,
91
- ...(disambiguation ? { disambiguation } : {}),
92
147
  artistCredit: artistCreditString(normalizeArtistCredits(e['artist-credit'])),
93
148
  ...(length ? { length } : {}),
94
149
  ...(e.isrcs?.length ? { isrcs: e.isrcs } : {}),
150
+ ...(e['first-release-date'] ? { firstReleaseDate: e['first-release-date'] } : {}),
95
151
  };
96
152
  }
97
153
  // release-group | release
@@ -103,22 +159,30 @@ function mapHit(type, raw) {
103
159
  const primaryType = isReleaseGroup ? e['primary-type'] : undefined;
104
160
  const status = !isReleaseGroup ? e.status : undefined;
105
161
  return {
106
- mbid: e.id,
162
+ ...shared,
107
163
  name: e.title ?? '',
108
- score,
109
- ...(disambiguation ? { disambiguation } : {}),
110
164
  ...(primaryType ? { type: primaryType } : {}),
165
+ ...(isReleaseGroup && e['secondary-types']?.length
166
+ ? { secondaryTypes: e['secondary-types'] }
167
+ : {}),
111
168
  ...(status ? { status } : {}),
112
169
  artistCredit: artistCreditString(normalizeArtistCredits(e['artist-credit'])),
113
170
  ...(date ? { date } : {}),
114
171
  ...(e.country ? { country: e.country } : {}),
172
+ ...(!isReleaseGroup ? mapReleaseEdition(e) : {}),
115
173
  };
116
174
  }
117
175
  export const searchEntitiesTool = tool('musicbrainz_search_entities', {
118
176
  title: 'musicbrainz-mcp-server: search entities',
119
- description: 'Full-text search across a MusicBrainz entity type (artist, release-group, release, recording, work, label) using a Lucene query string. Returns ranked matches with MBID, name/title, disambiguation, subtype where applicable, release status, and a 0–100 relevance score (100 = exact). Release rows use status; other entity subtypes use type. Starting point when resolving a name to an MBID — chain the returned MBID into the matching musicbrainz_get_* tool. Results are in MusicBrainz score-descending order. Supports field-scoped Lucene syntax (e.g. `artist:radiohead AND country:GB`).',
177
+ description: 'Full-text Lucene search for artist, release-group, release, recording, work, label or area. Returns matches in MusicBrainz score-descending order, with MBIDs and type-specific metadata. Use area search (e.g. area:seattle) to resolve musicbrainz_browse_entities link.area. Area rows include ISO codes and immediate parents where available. Chain other MBIDs into the matching musicbrainz_get_* tool. Release rows include status and edition metadata where available. Release-groups include secondary types and recordings include first-release dates where available. Supports field scoping (e.g. artist:radiohead AND country:GB). Only the first 500 matches are accessible; narrow the query or browse complete linked sets.',
120
178
  annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
121
179
  errors: [
180
+ {
181
+ reason: 'search_window_exceeded',
182
+ code: JsonRpcErrorCode.ValidationError,
183
+ when: 'The offset is at or beyond the 500-match search window.',
184
+ recovery: 'Use an offset below 500 and narrow the query, or use musicbrainz_browse_entities for complete linked sets.',
185
+ },
122
186
  {
123
187
  reason: 'blank_query',
124
188
  code: JsonRpcErrorCode.ValidationError,
@@ -133,7 +197,12 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
133
197
  .min(1)
134
198
  .describe('Lucene query string; must contain non-whitespace text. Plain text matches names/titles; field scoping (e.g. `artist:`, `country:`, `tag:`) is supported. Sent to MusicBrainz exactly as given.'),
135
199
  limit: PageLimit,
136
- offset: z.number().int().min(0).default(0).describe('Result offset for pagination (0-based).'),
200
+ offset: z
201
+ .number()
202
+ .int()
203
+ .min(0)
204
+ .default(0)
205
+ .describe('Result offset for pagination (0-based, below 500). A page crossing the 500-match ceiling is reduced to the remaining window.'),
137
206
  }),
138
207
  output: z.object({
139
208
  entityType: z.string().describe('The entity type that was searched.'),
@@ -148,7 +217,7 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
148
217
  notice: z
149
218
  .string()
150
219
  .optional()
151
- .describe('Limit clamp and pagination guidance, including zero matches, exhausted pages, and empty-page discrepancies.'),
220
+ .describe('Limit clamp, pagination and area browse guidance, including zero matches, exhausted pages, and empty-page discrepancies.'),
152
221
  },
153
222
  async handler(input, ctx) {
154
223
  ctx.log.info('musicbrainz_search_entities', {
@@ -160,16 +229,24 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
160
229
  if (input.query.trim().length === 0) {
161
230
  throw ctx.fail('blank_query', 'The search query is blank — it contains only whitespace.');
162
231
  }
232
+ if (input.offset >= 500) {
233
+ throw ctx.fail('search_window_exceeded', 'MusicBrainz search exposes only the first 500 matches.');
234
+ }
163
235
  const service = getMusicBrainzService();
164
- const limit = applyPageLimit(input.limit, 'musicbrainz_search_entities', ctx);
236
+ const applied = applyPageLimit(input.limit, 'musicbrainz_search_entities', ctx);
237
+ const limit = Math.min(applied, 500 - input.offset);
165
238
  const envelope = await service.search(input.entityType, input.query, { limit, offset: input.offset }, ctx, { signal: ctx.signal });
166
239
  const key = MusicBrainzService.pluralKey(input.entityType);
167
- const rawHits = (envelope[key] ?? []);
240
+ const rawHits = envelope[key] ?? [];
168
241
  const results = rawHits.map((h) => mapHit(input.entityType, h));
169
242
  ctx.enrich.echo(input.query);
170
243
  const total = envelope.count;
171
244
  ctx.enrich.total(total);
172
- const notice = pageNotice(total, input.offset, results.length, input.limit, limit, `No ${input.entityType} matched "${input.query}". Broaden the query, check spelling, or try a different entityType.`);
245
+ const paging = pageNotice(total, input.offset, results.length, input.limit, applied, `No ${input.entityType} matched "${input.query}". Broaden the query, check spelling, or try a different entityType.`, limit);
246
+ const areaBrowse = input.entityType === 'area' && results.length > 0
247
+ ? 'Use a returned area MBID as link.area in musicbrainz_browse_entities.'
248
+ : undefined;
249
+ const notice = [paging, areaBrowse].filter(Boolean).join(' ');
173
250
  if (notice)
174
251
  ctx.enrich.notice(notice);
175
252
  return { entityType: input.entityType, offset: input.offset, results };
@@ -185,6 +262,10 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
185
262
  lines.push(`**MBID:** ${r.mbid} | **Score:** ${r.score}`);
186
263
  if (r.type)
187
264
  lines.push(`**Type:** ${safeText(r.type)}`);
265
+ if (r.secondaryTypes?.length)
266
+ lines.push(`**Secondary types:** ${r.secondaryTypes.map(safeText).join(', ')}`);
267
+ if (r.firstReleaseDate)
268
+ lines.push(`**First release date:** ${safeText(r.firstReleaseDate)}`);
188
269
  if (r.status)
189
270
  lines.push(`**Status:** ${safeText(r.status)}`);
190
271
  if (r.artistCredit)
@@ -199,6 +280,16 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
199
280
  lines.push(`**ISRCs:** ${r.isrcs.join(', ')}`);
200
281
  if (r.iswcs?.length)
201
282
  lines.push(`**ISWCs:** ${r.iswcs.join(', ')}`);
283
+ if (r.iso3166_1)
284
+ lines.push(`**ISO 3166-1:** ${r.iso3166_1.map(safeText).join(', ')}`);
285
+ if (r.iso3166_2)
286
+ lines.push(`**ISO 3166-2:** ${r.iso3166_2.map(safeText).join(', ')}`);
287
+ if (r.iso3166_3)
288
+ lines.push(`**ISO 3166-3:** ${r.iso3166_3.map(safeText).join(', ')}`);
289
+ for (const parent of r.partOf ?? []) {
290
+ lines.push(`**Part of:** ${safeText(parent.name)} — ${parent.mbid}`);
291
+ }
292
+ lines.push(...renderReleaseEdition(r));
202
293
  }
203
294
  return [{ type: 'text', text: lines.join('\n') }];
204
295
  },
@@ -1 +1 @@
1
- {"version":3,"file":"search-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"search-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"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"}
@@ -13,7 +13,17 @@
13
13
  */
14
14
  import type { Context } from '@cyanheads/mcp-ts-core';
15
15
  import { RateLimiter } from './rate-limiter.js';
16
- import type { BrowseEnvelope, BrowseLink, CallOptions, EntityType, IsrcEnvelope, SearchEnvelope } from './types.js';
16
+ import type { BrowseEnvelope, BrowseLink, CallOptions, EntityType, IsrcEnvelope, ReleaseGroupStatus, SearchEntityType, SearchEnvelope } from './types.js';
17
+ /** Pluralized search/browse array keys, by entity type. */
18
+ declare const ENTITY_PLURAL: {
19
+ readonly area: 'areas';
20
+ readonly artist: 'artists';
21
+ readonly 'release-group': 'release-groups';
22
+ readonly release: 'releases';
23
+ readonly recording: 'recordings';
24
+ readonly work: 'works';
25
+ readonly label: 'labels';
26
+ };
17
27
  export interface SearchParams {
18
28
  limit: number;
19
29
  offset: number;
@@ -27,6 +37,12 @@ export interface BrowseParams {
27
37
  link: BrowseLink;
28
38
  linkMbid: string;
29
39
  offset: number;
40
+ /** Website visibility filter for release-group browse by artist. */
41
+ release_group_status?: ReleaseGroupStatus;
42
+ /** Canonical upstream pipe-separated release statuses. */
43
+ status?: string;
44
+ /** Canonical upstream pipe-separated release types. */
45
+ type?: string;
30
46
  }
31
47
  /**
32
48
  * Facade over the MusicBrainz WS/2 endpoints. Every public method runs through
@@ -41,7 +57,7 @@ export declare class MusicBrainzService {
41
57
  private readonly userAgent;
42
58
  constructor(baseUrl: string, contact: string, version: string, limiter: RateLimiter, cacheTtlSeconds: number, timeoutMs: number, maxRetries: number);
43
59
  /** Full-text Lucene search over an entity type. Returns the raw search envelope. */
44
- search(type: EntityType, query: string, params: SearchParams, ctx: Context, options?: CallOptions): Promise<SearchEnvelope & {
60
+ search(type: SearchEntityType, query: string, params: SearchParams, ctx: Context, options?: CallOptions): Promise<SearchEnvelope & {
45
61
  count: number;
46
62
  }>;
47
63
  /** Look up one entity by MBID with the requested `inc` sub-resources folded in. */
@@ -61,7 +77,7 @@ export declare class MusicBrainzService {
61
77
  resolveIsrc(value: string, ctx: Context, options?: CallOptions): Promise<IsrcEnvelope>;
62
78
  resolveIswc(value: string, ctx: Context, options?: CallOptions): Promise<BrowseEnvelope>;
63
79
  /** Pluralized array key for an entity type — for handlers reading search/browse envelopes. */
64
- static pluralKey(type: EntityType): keyof SearchEnvelope & keyof BrowseEnvelope;
80
+ static pluralKey<T extends SearchEntityType>(type: T): (typeof ENTITY_PLURAL)[T];
65
81
  /**
66
82
  * Core request pipeline: cache check → rate-limited, retried fetch + parse →
67
83
  * endpoint validation → cache store. Malformed totals neither retry nor cache.
@@ -88,4 +104,5 @@ export declare function initMusicBrainzService(version: string): void;
88
104
  export declare function getMusicBrainzService(): MusicBrainzService;
89
105
  /** Reset the service singleton — test-only seam. */
90
106
  export declare function resetMusicBrainzService(): void;
107
+ export {};
91
108
  //# sourceMappingURL=musicbrainz-service.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"musicbrainz-service.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"musicbrainz-service.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"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"}
@@ -30,6 +30,7 @@ function cacheKey(prefix, path) {
30
30
  }
31
31
  /** Pluralized search/browse array keys, by entity type. */
32
32
  const ENTITY_PLURAL = {
33
+ area: 'areas',
33
34
  artist: 'artists',
34
35
  'release-group': 'release-groups',
35
36
  release: 'releases',
@@ -82,9 +83,19 @@ export class MusicBrainzService {
82
83
  offset: String(params.offset),
83
84
  fmt: 'json',
84
85
  });
85
- if (target === 'release-group' || target === 'release' || target === 'recording') {
86
+ if (target === 'release') {
87
+ search.set('inc', 'artist-credits+labels+media+release-groups');
88
+ }
89
+ else if (target === 'release-group' || target === 'recording') {
86
90
  search.set('inc', 'artist-credits');
87
91
  }
92
+ if (params.type)
93
+ search.set('type', params.type);
94
+ if (params.status)
95
+ search.set('status', params.status);
96
+ if (params.release_group_status) {
97
+ search.set('release-group-status', params.release_group_status);
98
+ }
88
99
  return await this.request(`/${target}?${search.toString()}`, ctx, options, (envelope) => this.validateCount(envelope[`${target}-count`]));
89
100
  }
90
101
  /** Require an exact upstream total only on search and browse responses. */