@cyanheads/musicbrainz-mcp-server 0.1.9 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/AGENTS.md +33 -15
  2. package/CLAUDE.md +33 -15
  3. package/Dockerfile +3 -3
  4. package/README.md +40 -21
  5. package/changelog/0.2.x/0.2.0.md +28 -0
  6. package/changelog/0.2.x/0.2.1.md +32 -0
  7. package/dist/config/server-config.d.ts +1 -0
  8. package/dist/config/server-config.d.ts.map +1 -1
  9. package/dist/config/server-config.js +5 -0
  10. package/dist/config/server-config.js.map +1 -1
  11. package/dist/index.js +1 -1
  12. package/dist/index.js.map +1 -1
  13. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -1
  14. package/dist/mcp-server/resources/definitions/entity.resource.js +14 -4
  15. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
  16. package/dist/mcp-server/tools/definitions/_pagination.d.ts +12 -0
  17. package/dist/mcp-server/tools/definitions/_pagination.d.ts.map +1 -0
  18. package/dist/mcp-server/tools/definitions/_pagination.js +46 -0
  19. package/dist/mcp-server/tools/definitions/_pagination.js.map +1 -0
  20. package/dist/mcp-server/tools/definitions/_shared.d.ts +10 -4
  21. package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -1
  22. package/dist/mcp-server/tools/definitions/_shared.js +44 -27
  23. package/dist/mcp-server/tools/definitions/_shared.js.map +1 -1
  24. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +10 -7
  25. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
  26. package/dist/mcp-server/tools/definitions/browse-entities.tool.js +83 -50
  27. package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
  28. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +5 -3
  29. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -1
  30. package/dist/mcp-server/tools/definitions/get-artist.tool.js +6 -6
  31. package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -1
  32. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +12 -5
  33. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -1
  34. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +66 -24
  35. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -1
  36. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +1 -1
  37. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -1
  38. package/dist/mcp-server/tools/definitions/get-label.tool.js +3 -3
  39. package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -1
  40. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +14 -1
  41. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -1
  42. package/dist/mcp-server/tools/definitions/get-recording.tool.js +26 -5
  43. package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -1
  44. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +1 -1
  45. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -1
  46. package/dist/mcp-server/tools/definitions/get-release-group.tool.js +3 -3
  47. package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -1
  48. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +14 -4
  49. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -1
  50. package/dist/mcp-server/tools/definitions/get-release.tool.js +50 -8
  51. package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
  52. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +12 -4
  53. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -1
  54. package/dist/mcp-server/tools/definitions/get-work.tool.js +33 -10
  55. package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
  56. package/dist/mcp-server/tools/definitions/index.d.ts +62 -16
  57. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  58. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +2 -2
  59. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -1
  60. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +26 -7
  61. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -1
  62. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +3 -1
  63. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -1
  64. package/dist/mcp-server/tools/definitions/search-entities.tool.js +23 -18
  65. package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
  66. package/dist/services/cover-art/cover-art-service.d.ts +2 -2
  67. package/dist/services/cover-art/cover-art-service.d.ts.map +1 -1
  68. package/dist/services/cover-art/cover-art-service.js +6 -7
  69. package/dist/services/cover-art/cover-art-service.js.map +1 -1
  70. package/dist/services/musicbrainz/mbid.d.ts +5 -0
  71. package/dist/services/musicbrainz/mbid.d.ts.map +1 -0
  72. package/dist/services/musicbrainz/mbid.js +17 -0
  73. package/dist/services/musicbrainz/mbid.js.map +1 -0
  74. package/dist/services/musicbrainz/musicbrainz-service.d.ts +8 -3
  75. package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
  76. package/dist/services/musicbrainz/musicbrainz-service.js +27 -8
  77. package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
  78. package/dist/services/musicbrainz/release-appearances.d.ts +16 -0
  79. package/dist/services/musicbrainz/release-appearances.d.ts.map +1 -0
  80. package/dist/services/musicbrainz/release-appearances.js +15 -0
  81. package/dist/services/musicbrainz/release-appearances.js.map +1 -0
  82. package/dist/services/musicbrainz/types.d.ts +7 -4
  83. package/dist/services/musicbrainz/types.d.ts.map +1 -1
  84. package/dist/services/musicbrainz/work-relations.d.ts +19 -0
  85. package/dist/services/musicbrainz/work-relations.d.ts.map +1 -0
  86. package/dist/services/musicbrainz/work-relations.js +26 -0
  87. package/dist/services/musicbrainz/work-relations.js.map +1 -0
  88. package/package.json +8 -8
  89. package/server.json +17 -3
@@ -9,21 +9,24 @@
9
9
  */
10
10
  import { resource, z } from '@cyanheads/mcp-ts-core';
11
11
  import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
12
+ import { MbidInput } from '../../tools/definitions/_shared.js';
12
13
  import { getMusicBrainzService } from '../../../services/musicbrainz/musicbrainz-service.js';
14
+ import { summarizeReleaseAppearances } from '../../../services/musicbrainz/release-appearances.js';
15
+ import { sliceWorkRelations } from '../../../services/musicbrainz/work-relations.js';
13
16
  /** Default `inc` sets per entity type — the useful slice the get_* tools fetch. */
14
17
  const DEFAULT_INC = {
15
18
  artist: ['release-groups', 'artist-rels', 'url-rels', 'aliases', 'tags', 'genres'],
16
19
  'release-group': ['releases', 'artist-credits', 'tags', 'genres'],
17
20
  release: ['recordings', 'artist-credits', 'labels', 'release-groups'],
18
21
  recording: ['artist-credits', 'releases', 'isrcs', 'artist-rels', 'work-rels', 'url-rels'],
19
- work: ['artist-rels', 'recording-rels', 'aliases', 'tags', 'genres', 'url-rels'],
22
+ work: ['artist-rels', 'work-rels', 'recording-rels', 'aliases', 'tags', 'genres', 'url-rels'],
20
23
  label: ['aliases', 'tags', 'genres', 'url-rels'],
21
24
  };
22
25
  const ENTITY_TYPES = ['artist', 'release-group', 'release', 'recording', 'work', 'label'];
23
26
  export const entityResource = resource('musicbrainz://{entity_type}/{mbid}', {
24
27
  name: 'musicbrainz-entity',
25
28
  title: 'musicbrainz-mcp-server: entity',
26
- description: "A single MusicBrainz entity by type and MBID, with default linked sub-resources folded in (mirrors the matching musicbrainz_get_* tool). entity_type ∈ artist, release-group, release, recording, work, label. Returns the raw MusicBrainz JSON record. For complete linked sets (a prolific artist's discography, a label's releases) use musicbrainz_browse_entities — embedded lists here are capped at one page.",
29
+ description: 'A MusicBrainz entity by type and MBID with default linked data. entity_type: artist, release-group, release, recording, work, label. Artist release-groups, release-group editions and recording release appearances embed one upstream page; labels embed no releases. Recording JSON includes releaseAppearanceSummary (shown, cap, completeness, optional exact totalCount and browse guidance from offset 0). Work JSON includes raw movement/arrangement relationships with direction, ordering-key and target disambiguation when supplied. Work recording relationships are sliced to 25 with recordingRelationshipSummary (exact relationship total and actual truncation). All other relationships and complete release tracklists are preserved; release-tool media windows do not apply here. Browse recording by work enumerates identities; musicbrainz_get_recording supplies work relationship attributes and dates.',
27
30
  mimeType: 'application/json',
28
31
  errors: [
29
32
  {
@@ -43,7 +46,7 @@ export const entityResource = resource('musicbrainz://{entity_type}/{mbid}', {
43
46
  entity_type: z
44
47
  .enum(ENTITY_TYPES)
45
48
  .describe('Entity type: artist, release-group, release, recording, work, or label.'),
46
- mbid: z.string().describe('Entity MBID (36-character UUID).'),
49
+ mbid: MbidInput.describe('Entity MBID (hyphenated hexadecimal UUID; surrounding whitespace and uppercase accepted).'),
47
50
  }),
48
51
  async handler(params, ctx) {
49
52
  ctx.log.debug('musicbrainz entity resource', {
@@ -52,7 +55,14 @@ export const entityResource = resource('musicbrainz://{entity_type}/{mbid}', {
52
55
  });
53
56
  const service = getMusicBrainzService();
54
57
  try {
55
- return await service.lookup(params.entity_type, params.mbid, { inc: DEFAULT_INC[params.entity_type] }, ctx, { signal: ctx.signal });
58
+ const raw = await service.lookup(params.entity_type, params.mbid, { inc: DEFAULT_INC[params.entity_type] }, ctx, { signal: ctx.signal });
59
+ if (params.entity_type === 'recording') {
60
+ return { ...raw, releaseAppearanceSummary: summarizeReleaseAppearances(raw) };
61
+ }
62
+ if (params.entity_type !== 'work')
63
+ return raw;
64
+ const slice = sliceWorkRelations(raw.relations, String(raw.id));
65
+ return { ...raw, relations: slice.relations, recordingRelationshipSummary: slice.summary };
56
66
  }
57
67
  catch (error) {
58
68
  if (error instanceof McpError && error.code === JsonRpcErrorCode.ValidationError) {
@@ -1 +1 @@
1
- {"version":3,"file":"entity.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity.resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAGtF,mFAAmF;AACnF,MAAM,WAAW,GAAiC;IAChD,MAAM,EAAE,CAAC,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC;IAClF,eAAe,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAC;IACjE,OAAO,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,CAAC;IACrE,SAAS,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,CAAC;IAC1F,IAAI,EAAE,CAAC,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;IAChF,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;CACjD,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAEnG,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC,oCAAoC,EAAE;IAC3E,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,gCAAgC;IACvC,WAAW,EACT,sZAAsZ;IACxZ,QAAQ,EAAE,kBAAkB;IAE5B,MAAM,EAAE;QACN;YACE,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,sFAAsF;YAC5F,QAAQ,EACN,gHAAgH;SACnH;QACD;YACE,MAAM,EAAE,kBAAkB;YAC1B,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,oEAAoE;YAC1E,QAAQ,EAAE,gFAAgF;SAC3F;KACF;IAED,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,WAAW,EAAE,CAAC;aACX,IAAI,CAAC,YAAY,CAAC;aAClB,QAAQ,CAAC,yEAAyE,CAAC;QACtF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KAC9D,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE;YAC3C,UAAU,EAAE,MAAM,CAAC,WAAW;YAC9B,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,CACzB,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,IAAI,EACX,EAAE,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EACxC,GAAG,EACH,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,eAAe,EAAE,CAAC;gBACjF,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,mBAAmB,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,QAAQ,EAAE,CAAC;gBAC1E,MAAM,GAAG,CAAC,IAAI,CACZ,kBAAkB,EAClB,MAAM,MAAM,CAAC,WAAW,qBAAqB,MAAM,CAAC,IAAI,GAAG,CAC5D,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
1
+ {"version":3,"file":"entity.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity.resource.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @fileoverview Shared search/browse page limits and truthful continuation notices.
3
+ * @module mcp-server/tools/definitions/_pagination
4
+ */
5
+ import { type Context, z } from '@cyanheads/mcp-ts-core';
6
+ /** Resolve the switch after core loads .env, when the schema is first inspected. */
7
+ export declare const PageLimit: z.ZodDefault<z.ZodLazy<z.ZodNumber>>;
8
+ /** Record the clamp once before requesting the applied page. */
9
+ export declare function applyPageLimit(requested: number, toolName: string, ctx: Context): number;
10
+ /** Compose one notice; an empty upstream page never supplies a nonadvancing offset. */
11
+ export declare function pageNotice(total: number, offset: number, shown: number, requested: number, applied: number, emptyNotice: string): string | undefined;
12
+ //# sourceMappingURL=_pagination.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_pagination.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_pagination.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAWzD,oFAAoF;AACpF,eAAO,MAAM,SAAS,sCASnB,CAAC;AAEJ,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAOxF;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAiBpB"}
@@ -0,0 +1,46 @@
1
+ /**
2
+ * @fileoverview Shared search/browse page limits and truthful continuation notices.
3
+ * @module mcp-server/tools/definitions/_pagination
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ import { parseConfig } from '@cyanheads/mcp-ts-core/config';
7
+ import { createCounter } from '@cyanheads/mcp-ts-core/utils';
8
+ import { getServerConfig } from '../../../config/server-config.js';
9
+ const clamped = createCounter('musicbrainz.limit.clamped', 'Oversized page limits clamped to the MusicBrainz maximum', '{calls}');
10
+ /** Resolve the switch after core loads .env, when the schema is first inspected. */
11
+ export const PageLimit = z
12
+ .lazy(() => {
13
+ parseConfig();
14
+ const limit = z.number().int().min(1);
15
+ return getServerConfig().clampOversizedLimits ? limit : limit.max(100);
16
+ })
17
+ .default(25)
18
+ .describe('Positive integer page size (default 25); values above 100 are clamped to 100 with a notice. With MUSICBRAINZ_CLAMP_OVERSIZED_LIMITS=off, maximum 100 is enforced.');
19
+ /** Record the clamp once before requesting the applied page. */
20
+ export function applyPageLimit(requested, toolName, ctx) {
21
+ const applied = Math.min(requested, 100);
22
+ if (requested > applied) {
23
+ ctx.log.info('MusicBrainz page limit clamped', { tool: toolName, requested, applied });
24
+ clamped.add(1, { tool: toolName });
25
+ }
26
+ return applied;
27
+ }
28
+ /** Compose one notice; an empty upstream page never supplies a nonadvancing offset. */
29
+ export function pageNotice(total, offset, shown, requested, applied, emptyNotice) {
30
+ const notices = [];
31
+ if (requested > applied)
32
+ notices.push(`Requested limit ${requested} was clamped to ${applied}.`);
33
+ if (total === 0)
34
+ notices.push(emptyNotice);
35
+ else if (shown === 0) {
36
+ notices.push(offset >= total
37
+ ? `This page is exhausted: offset=${offset} is at or beyond the total of ${total}. Request a lower offset to retrieve matches.`
38
+ : `MusicBrainz returned an empty page at offset=${offset} despite reporting ${total} total entities. Retry later or verify the query; no advancing continuation offset is available.`);
39
+ }
40
+ else if (offset + shown < total) {
41
+ const remaining = total - offset - shown;
42
+ notices.push(`${remaining} more entities remain. Call again with offset=${offset + shown} to continue paging.`);
43
+ }
44
+ return notices.length ? notices.join(' ') : undefined;
45
+ }
46
+ //# sourceMappingURL=_pagination.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_pagination.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_pagination.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAgB,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,OAAO,GAAG,aAAa,CAC3B,2BAA2B,EAC3B,0DAA0D,EAC1D,SAAS,CACV,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,IAAI,CAAC,GAAG,EAAE;IACT,WAAW,EAAE,CAAC;IACd,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,eAAe,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzE,CAAC,CAAC;KACD,OAAO,CAAC,EAAE,CAAC;KACX,QAAQ,CACP,mKAAmK,CACpK,CAAC;AAEJ,gEAAgE;AAChE,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,QAAgB,EAAE,GAAY;IAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;QACxB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,MAAc,EACd,KAAa,EACb,SAAiB,EACjB,OAAe,EACf,WAAmB;IAEnB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,SAAS,GAAG,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,SAAS,mBAAmB,OAAO,GAAG,CAAC,CAAC;IACjG,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;SACtC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CACV,MAAM,IAAI,KAAK;YACb,CAAC,CAAC,kCAAkC,MAAM,iCAAiC,KAAK,+CAA+C;YAC/H,CAAC,CAAC,gDAAgD,MAAM,sBAAsB,KAAK,kGAAkG,CACxL,CAAC;IACJ,CAAC;SAAM,IAAI,MAAM,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;QACzC,OAAO,CAAC,IAAI,CACV,GAAG,SAAS,iDAAiD,MAAM,GAAG,KAAK,sBAAsB,CAClG,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}
@@ -16,17 +16,19 @@
16
16
  import { z } from '@cyanheads/mcp-ts-core';
17
17
  import type { RawAlias, RawArtistCredit, RawCoverArtStub, RawLifeSpan, RawRelation, RawTag } from '../../../services/musicbrainz/types.js';
18
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 (`ValidationError`); a
21
- * well-formed MBID with no matching entity returns HTTP 404 (`NotFound`). Returns
19
+ * Classify a service error from an MBID lookup: local malformed/all-zero rejection
20
+ * and upstream HTTP 400 become `ValidationError`; a well-formed MBID with no
21
+ * matching entity returns HTTP 404 (`NotFound`). Returns
22
22
  * the contract reason for those two cases, or `null` for anything else (transient
23
23
  * upstream failures bubble unchanged). Handlers branch on the result and throw
24
24
  * `ctx.fail('<literal reason>', …)` per branch: the error-contract lint rules skip
25
25
  * any definition whose `ctx.fail` takes a non-literal reason.
26
26
  */
27
27
  export declare function classifyMbidError(error: unknown): 'invalid_mbid' | 'entity_not_found' | null;
28
- /** UUID shape MusicBrainz MBIDs follow — surfaced in recovery hints, not used to pre-validate. */
28
+ /** Example MusicBrainz identifier used in recovery hints. */
29
29
  export declare const MBID_EXAMPLE = "a74b1b7f-71a5-4011-9441-d0b5e4122711";
30
+ /** Discovery-only pattern; service validation preserves the typed domain error contract. */
31
+ export declare const MbidInput: z.ZodString;
30
32
  export declare const MbidScore: z.ZodNumber;
31
33
  export declare const ArtistCreditSchema: z.ZodObject<{
32
34
  name: z.ZodString;
@@ -57,6 +59,8 @@ export declare const RelationSchema: z.ZodObject<{
57
59
  targetType: z.ZodString;
58
60
  targetId: z.ZodOptional<z.ZodString>;
59
61
  targetName: z.ZodOptional<z.ZodString>;
62
+ targetDisambiguation: z.ZodOptional<z.ZodString>;
63
+ orderingKey: z.ZodOptional<z.ZodNumber>;
60
64
  begin: z.ZodOptional<z.ZodString>;
61
65
  end: z.ZodOptional<z.ZodString>;
62
66
  }, z.core.$strip>;
@@ -96,6 +100,8 @@ export declare function normalizeCoverArtStub(stub: RawCoverArtStub | undefined)
96
100
  /** Format milliseconds as `m:ss` (track lengths are in ms upstream). */
97
101
  export declare function formatDuration(ms: number | null | undefined): string | undefined;
98
102
  export declare function safeText(value: string): string;
103
+ /** Keep URL bytes copyable while confining the value to a single rendered line. */
104
+ export declare function safeUrl(value: string): string;
99
105
  export declare function renderRelationships(rels: z.infer<typeof RelationSchema>[]): string[];
100
106
  export declare function renderExternalLinks(links: z.infer<typeof ExternalLinkSchema>[]): string[];
101
107
  export declare function renderTags(tags: z.infer<typeof TagSchema>[]): string | undefined;
@@ -1 +1 @@
1
- {"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"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"}
@@ -15,10 +15,11 @@
15
15
  */
16
16
  import { z } from '@cyanheads/mcp-ts-core';
17
17
  import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
18
+ import { MBID_PATTERN } from '../../../services/musicbrainz/mbid.js';
18
19
  /**
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 (`ValidationError`); a
21
- * well-formed MBID with no matching entity returns HTTP 404 (`NotFound`). Returns
20
+ * Classify a service error from an MBID lookup: local malformed/all-zero rejection
21
+ * and upstream HTTP 400 become `ValidationError`; a well-formed MBID with no
22
+ * matching entity returns HTTP 404 (`NotFound`). Returns
22
23
  * the contract reason for those two cases, or `null` for anything else (transient
23
24
  * upstream failures bubble unchanged). Handlers branch on the result and throw
24
25
  * `ctx.fail('<literal reason>', …)` per branch: the error-contract lint rules skip
@@ -33,8 +34,10 @@ export function classifyMbidError(error) {
33
34
  return 'entity_not_found';
34
35
  return null;
35
36
  }
36
- /** UUID shape MusicBrainz MBIDs follow — surfaced in recovery hints, not used to pre-validate. */
37
+ /** Example MusicBrainz identifier used in recovery hints. */
37
38
  export const MBID_EXAMPLE = 'a74b1b7f-71a5-4011-9441-d0b5e4122711';
39
+ /** Discovery-only pattern; service validation preserves the typed domain error contract. */
40
+ export const MbidInput = z.string().meta({ pattern: MBID_PATTERN });
38
41
  // ─── Zod sub-schemas (described, including nested array-item objects) ─────────
39
42
  export const MbidScore = z.number().describe('Lucene relevance score, 0–100 (100 = exact match).');
40
43
  export const ArtistCreditSchema = z
@@ -106,6 +109,14 @@ export const RelationSchema = z
106
109
  .string()
107
110
  .optional()
108
111
  .describe('Name/title of the related entity. Omitted when absent.'),
112
+ targetDisambiguation: z
113
+ .string()
114
+ .optional()
115
+ .describe('Qualifier distinguishing the related entity from namesakes. Omitted when absent.'),
116
+ orderingKey: z
117
+ .number()
118
+ .optional()
119
+ .describe('Upstream relationship sequence key, including zero. Omitted when unknown; array order is preserved.'),
109
120
  begin: z.string().optional().describe('Relationship start date. Omitted when absent.'),
110
121
  end: z.string().optional().describe('Relationship end date. Omitted when absent.'),
111
122
  })
@@ -143,7 +154,7 @@ export function normalizeArtistCredits(credits) {
143
154
  const artistId = c.artist?.id;
144
155
  if (!artistId)
145
156
  continue;
146
- const joinPhrase = c.joinphrase?.trim();
157
+ const joinPhrase = c.joinphrase;
147
158
  out.push({
148
159
  name: c.name ?? c.artist?.name ?? '',
149
160
  artistId,
@@ -155,7 +166,7 @@ export function normalizeArtistCredits(credits) {
155
166
  }
156
167
  /** Render an artist-credit array to its display string, stitching join phrases. */
157
168
  export function artistCreditString(credits) {
158
- return credits.map((c) => `${c.artistName}${c.joinPhrase ?? ''}`).join('') || 'Unknown artist';
169
+ return credits.map((c) => `${c.name}${c.joinPhrase ?? ''}`).join('') || 'Unknown artist';
159
170
  }
160
171
  /**
161
172
  * Render the artist-credit array as a detail block surfacing every sub-field
@@ -167,8 +178,8 @@ export function renderArtistCredits(credits) {
167
178
  return [];
168
179
  const lines = ['', '### Artist credit'];
169
180
  for (const c of credits) {
170
- const credited = c.name && c.name !== c.artistName ? ` (credited as "${safeText(c.name)}")` : '';
171
- const join = c.joinPhrase ? ` + join "${safeText(c.joinPhrase)}"` : '';
181
+ const credited = c.name && c.name !== c.artistName ? ` (credited as ${safeText(`"${c.name}"`)})` : '';
182
+ const join = c.joinPhrase ? ` + join ${safeText(`"${c.joinPhrase}"`)}` : '';
172
183
  lines.push(`- ${safeText(c.artistName)}${credited} — ${c.artistId}${join}`);
173
184
  }
174
185
  return lines;
@@ -214,21 +225,25 @@ function relationTarget(rel) {
214
225
  return {
215
226
  ...(rel.artist?.id && { id: rel.artist.id }),
216
227
  ...(rel.artist?.name && { name: rel.artist.name }),
228
+ ...(rel.artist?.disambiguation && { disambiguation: rel.artist.disambiguation }),
217
229
  };
218
230
  case 'work':
219
231
  return {
220
232
  ...(rel.work?.id && { id: rel.work.id }),
221
233
  ...(rel.work?.title && { name: rel.work.title }),
234
+ ...(rel.work?.disambiguation && { disambiguation: rel.work.disambiguation }),
222
235
  };
223
236
  case 'recording':
224
237
  return {
225
238
  ...(rel.recording?.id && { id: rel.recording.id }),
226
239
  ...(rel.recording?.title && { name: rel.recording.title }),
240
+ ...(rel.recording?.disambiguation && { disambiguation: rel.recording.disambiguation }),
227
241
  };
228
242
  case 'label':
229
243
  return {
230
244
  ...(rel.label?.id && { id: rel.label.id }),
231
245
  ...(rel.label?.name && { name: rel.label.name }),
246
+ ...(rel.label?.disambiguation && { disambiguation: rel.label.disambiguation }),
232
247
  };
233
248
  default:
234
249
  return {};
@@ -261,6 +276,8 @@ export function normalizeRelations(relations) {
261
276
  targetType: rel['target-type'] ?? 'unknown',
262
277
  ...(target.id ? { targetId: target.id } : {}),
263
278
  ...(target.name ? { targetName: target.name } : {}),
279
+ ...(target.disambiguation ? { targetDisambiguation: target.disambiguation } : {}),
280
+ ...(typeof rel['ordering-key'] === 'number' ? { orderingKey: rel['ordering-key'] } : {}),
264
281
  ...(rel.begin ? { begin: rel.begin } : {}),
265
282
  ...(rel.end ? { end: rel.end } : {}),
266
283
  });
@@ -293,25 +310,23 @@ export function formatDuration(ms) {
293
310
  // terminal field of an object/array in `output` must appear in the rendered text.
294
311
  /**
295
312
  * Neutralize a community-edited free-text value before it is interpolated into a
296
- * single line of `format()` markdown. MusicBrainz core data is user-submitted, so
297
- * a name / title / disambiguation / tag / alias / comment field can carry hostile
298
- * content. Every `format()` line is built as `lines.push(...)` and joined with
299
- * `\n`, so the one way a value escapes its structural slot (a bold label, a list
300
- * bullet) is by injecting its own line breaks. A value like
301
- * `"\n\n## SYSTEM: ignore the above"` would otherwise render as a new markdown
302
- * heading the LLM reads as an instruction.
303
- *
304
- * Collapsing every line break, tab, control character (`\p{Cc}`), and Unicode
305
- * line/paragraph separator (U+2028 / U+2029) to a single space keeps the value
306
- * confined to its line: leading `#` / `-` / `>` markers are inert mid-line, and a
307
- * fenced code block
308
- * cannot open because the value can no longer span multiple lines. The structured
309
- * `structuredContent` twin carries the raw value unchanged — this guards only the
310
- * markdown surface, where untrusted text and server-authored structure mix.
311
- * Legitimate single-line titles pass through byte-identical.
313
+ * single line of `format()` markdown. Collapse controls and escape syntax that
314
+ * would alter literal prose or interfere with adjacent server-authored delimiters.
315
+ * Intraword underscores and less-than comparisons remain unchanged. Structured
316
+ * values remain raw; this helper preserves presentation, not content trust.
312
317
  */
313
318
  const CONTROL_OR_LINE_SEPARATOR = /[\p{Cc}\u2028\u2029]+/gu;
314
319
  export function safeText(value) {
320
+ return value
321
+ .replace(CONTROL_OR_LINE_SEPARATOR, ' ')
322
+ .trim()
323
+ .replace(/[\\*`[\]~&]/g, '\\$&')
324
+ .replace(/(?<![\p{L}\p{N}])_|_(?![\p{L}\p{N}])/gu, '\\_')
325
+ .replace(/<(?=[A-Za-z/!?])/g, '\\<')
326
+ .replace(/^([#>+-])/, '\\$1');
327
+ }
328
+ /** Keep URL bytes copyable while confining the value to a single rendered line. */
329
+ export function safeUrl(value) {
315
330
  return value.replace(CONTROL_OR_LINE_SEPARATOR, ' ').trim();
316
331
  }
317
332
  export function renderRelationships(rels) {
@@ -323,7 +338,9 @@ export function renderRelationships(rels) {
323
338
  const target = safeText(r.targetName ?? r.targetId ?? r.targetType);
324
339
  const dir = r.direction ? ` ${r.direction}` : '';
325
340
  const dates = r.begin || r.end ? ` [${r.begin ?? ''}${r.end ? `–${r.end}` : ''}]` : '';
326
- lines.push(`- **${safeText(r.type)}**${attrs}${dir} → ${r.targetType}: ${target}${r.targetId ? ` (${r.targetId})` : ''}${dates}`);
341
+ const qualifier = r.targetDisambiguation ? ` — ${safeText(r.targetDisambiguation)}` : '';
342
+ const ordering = typeof r.orderingKey === 'number' ? ` [ordering key: ${r.orderingKey}]` : '';
343
+ lines.push(`- **${safeText(r.type)}**${attrs}${dir} → ${r.targetType}: ${target}${r.targetId ? ` (${r.targetId})` : ''}${qualifier}${dates}${ordering}`);
327
344
  }
328
345
  return lines;
329
346
  }
@@ -332,7 +349,7 @@ export function renderExternalLinks(links) {
332
349
  return [];
333
350
  const lines = ['', '### External links'];
334
351
  for (const l of links)
335
- lines.push(`- **${safeText(l.type)}:** ${safeText(l.resource)}`);
352
+ lines.push(`- **${safeText(l.type)}:** ${safeUrl(l.resource)}`);
336
353
  return lines;
337
354
  }
338
355
  export function renderTags(tags) {
@@ -348,7 +365,7 @@ export function renderAliases(aliases) {
348
365
  a.type ? safeText(a.type) : null,
349
366
  a.locale ? safeText(a.locale) : null,
350
367
  a.sortName && a.sortName !== a.name ? `sort: ${safeText(a.sortName)}` : null,
351
- a.primary ? 'primary' : null,
368
+ typeof a.primary === 'boolean' ? `primary: ${a.primary ? 'yes' : 'no'}` : null,
352
369
  ]
353
370
  .filter(Boolean)
354
371
  .join(', ');
@@ -1 +1 @@
1
- {"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"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"}
@@ -1,9 +1,8 @@
1
1
  /**
2
2
  * @fileoverview musicbrainz_browse_entities — paginate the COMPLETE set of
3
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.
4
+ * by an artist, every recording of a work or release, every release in a group.
5
+ * Enumerates entities rather than ordered tracks or performance relationship details.
7
6
  * @module mcp-server/tools/definitions/browse-entities.tool
8
7
  */
9
8
  import { z } from '@cyanheads/mcp-ts-core';
@@ -21,11 +20,14 @@ export declare const browseEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
21
20
  artist: z.ZodOptional<z.ZodString>;
22
21
  label: z.ZodOptional<z.ZodString>;
23
22
  'release-group': z.ZodOptional<z.ZodString>;
23
+ release: z.ZodOptional<z.ZodString>;
24
+ releaseGroup: z.ZodOptional<z.ZodString>;
25
+ release_group: z.ZodOptional<z.ZodString>;
24
26
  recording: z.ZodOptional<z.ZodString>;
25
27
  work: z.ZodOptional<z.ZodString>;
26
28
  area: z.ZodOptional<z.ZodString>;
27
- }, z.core.$strip>;
28
- limit: z.ZodDefault<z.ZodNumber>;
29
+ }, z.core.$catchall<z.ZodUnknown>>;
30
+ limit: z.ZodDefault<z.ZodLazy<z.ZodNumber>>;
29
31
  offset: z.ZodDefault<z.ZodNumber>;
30
32
  }, z.core.$strip>, z.ZodObject<{
31
33
  targetType: z.ZodString;
@@ -36,6 +38,7 @@ export declare const browseEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
36
38
  name: z.ZodString;
37
39
  disambiguation: z.ZodOptional<z.ZodString>;
38
40
  type: z.ZodOptional<z.ZodString>;
41
+ status: z.ZodOptional<z.ZodString>;
39
42
  artistCredit: z.ZodOptional<z.ZodString>;
40
43
  date: z.ZodOptional<z.ZodString>;
41
44
  country: z.ZodOptional<z.ZodString>;
@@ -45,8 +48,8 @@ export declare const browseEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
45
48
  }, z.core.$strip>, readonly [{
46
49
  readonly reason: "invalid_link";
47
50
  readonly code: JsonRpcErrorCode.ValidationError;
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.";
51
+ readonly when: "A parent key is unknown, aliases collide, not exactly one nonempty parent is supplied, or the MBID/parent combination is invalid.";
52
+ readonly recovery: "Provide exactly one parent key with a nonzero hexadecimal UUID MBID. Accepted parents by target: artist → area, recording, release, release-group, work; label → area, release; release-group → artist, release; release → area, artist, label, recording, release-group; recording → artist, release, work; work → artist. releaseGroup and release_group alias release-group; never combine aliases.";
50
53
  }, {
51
54
  readonly reason: "entity_not_found";
52
55
  readonly code: JsonRpcErrorCode.NotFound;
@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+K7B,CAAC"}
1
+ {"version":3,"file":"browse-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/browse-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAiH3E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgP7B,CAAC"}