@cyanheads/musicbrainz-mcp-server 0.1.9 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +33 -15
- package/CLAUDE.md +33 -15
- package/Dockerfile +3 -3
- package/README.md +40 -21
- package/changelog/0.2.x/0.2.0.md +28 -0
- package/changelog/0.2.x/0.2.1.md +32 -0
- package/dist/config/server-config.d.ts +1 -0
- package/dist/config/server-config.d.ts.map +1 -1
- package/dist/config/server-config.js +5 -0
- package/dist/config/server-config.js.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/entity.resource.js +14 -4
- package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
- package/dist/mcp-server/tools/definitions/_pagination.d.ts +12 -0
- package/dist/mcp-server/tools/definitions/_pagination.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/_pagination.js +46 -0
- package/dist/mcp-server/tools/definitions/_pagination.js.map +1 -0
- package/dist/mcp-server/tools/definitions/_shared.d.ts +10 -4
- package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/_shared.js +44 -27
- package/dist/mcp-server/tools/definitions/_shared.js.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +10 -7
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js +83 -50
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +5 -3
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-artist.tool.js +6 -6
- package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +12 -5
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +66 -24
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-label.tool.js +3 -3
- package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +14 -1
- package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recording.tool.js +26 -5
- package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release-group.tool.js +3 -3
- package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +14 -4
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release.tool.js +50 -8
- package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +12 -4
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.js +33 -10
- package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +62 -16
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +2 -2
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +26 -7
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +3 -1
- package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-entities.tool.js +23 -18
- package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
- package/dist/services/cover-art/cover-art-service.d.ts +2 -2
- package/dist/services/cover-art/cover-art-service.d.ts.map +1 -1
- package/dist/services/cover-art/cover-art-service.js +6 -7
- package/dist/services/cover-art/cover-art-service.js.map +1 -1
- package/dist/services/musicbrainz/mbid.d.ts +5 -0
- package/dist/services/musicbrainz/mbid.d.ts.map +1 -0
- package/dist/services/musicbrainz/mbid.js +17 -0
- package/dist/services/musicbrainz/mbid.js.map +1 -0
- package/dist/services/musicbrainz/musicbrainz-service.d.ts +8 -3
- package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
- package/dist/services/musicbrainz/musicbrainz-service.js +27 -8
- package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
- package/dist/services/musicbrainz/release-appearances.d.ts +16 -0
- package/dist/services/musicbrainz/release-appearances.d.ts.map +1 -0
- package/dist/services/musicbrainz/release-appearances.js +15 -0
- package/dist/services/musicbrainz/release-appearances.js.map +1 -0
- package/dist/services/musicbrainz/types.d.ts +7 -4
- package/dist/services/musicbrainz/types.d.ts.map +1 -1
- package/dist/services/musicbrainz/work-relations.d.ts +19 -0
- package/dist/services/musicbrainz/work-relations.d.ts.map +1 -0
- package/dist/services/musicbrainz/work-relations.js +26 -0
- package/dist/services/musicbrainz/work-relations.js.map +1 -0
- package/package.json +8 -8
- package/server.json +17 -3
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Lookup-only release appearance completeness for recording tool and resource views.
|
|
3
|
+
* @module services/musicbrainz/release-appearances
|
|
4
|
+
*/
|
|
5
|
+
import type { RawRecording } from './types.js';
|
|
6
|
+
/** Completeness evidence for the embedded upstream release page, without a count request. */
|
|
7
|
+
export interface ReleaseAppearanceSummary {
|
|
8
|
+
cap: number;
|
|
9
|
+
completeness: 'complete' | 'unknown' | 'truncated';
|
|
10
|
+
notice: string;
|
|
11
|
+
shown: number;
|
|
12
|
+
totalCount?: number;
|
|
13
|
+
}
|
|
14
|
+
/** A short present page proves completeness; a full or absent page needs an upstream count. */
|
|
15
|
+
export declare function summarizeReleaseAppearances(raw: Pick<RawRecording, 'id' | 'releases' | 'release-count'>): ReleaseAppearanceSummary;
|
|
16
|
+
//# sourceMappingURL=release-appearances.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"release-appearances.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/release-appearances.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,6FAA6F;AAC7F,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+FAA+F;AAC/F,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,UAAU,GAAG,eAAe,CAAC,GAC3D,wBAAwB,CAa1B"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/** A short present page proves completeness; a full or absent page needs an upstream count. */
|
|
2
|
+
export function summarizeReleaseAppearances(raw) {
|
|
3
|
+
const cap = 25;
|
|
4
|
+
const shown = raw.releases?.length ?? 0;
|
|
5
|
+
const totalCount = raw['release-count'] ?? (raw.releases && shown < cap ? shown : undefined);
|
|
6
|
+
const completeness = totalCount === undefined ? 'unknown' : totalCount > shown ? 'truncated' : 'complete';
|
|
7
|
+
return {
|
|
8
|
+
shown,
|
|
9
|
+
cap,
|
|
10
|
+
completeness,
|
|
11
|
+
...(totalCount === undefined ? {} : { totalCount }),
|
|
12
|
+
notice: `Enumerate release appearances with musicbrainz_browse_entities (target_type=release, link.recording=${raw.id}, offset=0). Start at offset=0 because the embedded page may use a different order from browse.`,
|
|
13
|
+
};
|
|
14
|
+
}
|
|
15
|
+
//# sourceMappingURL=release-appearances.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"release-appearances.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/release-appearances.ts"],"names":[],"mappings":"AAeA,+FAA+F;AAC/F,MAAM,UAAU,2BAA2B,CACzC,GAA4D;IAE5D,MAAM,GAAG,GAAG,EAAE,CAAC;IACf,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7F,MAAM,YAAY,GAChB,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;IACvF,OAAO;QACL,KAAK;QACL,GAAG;QACH,YAAY;QACZ,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;QACnD,MAAM,EAAE,uGAAuG,GAAG,CAAC,EAAE,iGAAiG;KACvN,CAAC;AACJ,CAAC"}
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
/** The six core entity types addressable by MBID across search, lookup, and browse. */
|
|
11
11
|
export type EntityType = 'artist' | 'release-group' | 'release' | 'recording' | 'work' | 'label';
|
|
12
12
|
/** Parent link types for the browse endpoint (one parent MBID per browse call). */
|
|
13
|
-
export type BrowseLink = 'artist' | 'label' | 'release-group' | 'recording' | 'work' | 'area';
|
|
13
|
+
export type BrowseLink = 'artist' | 'label' | 'release-group' | 'release' | 'recording' | 'work' | 'area';
|
|
14
14
|
/** A life span / date range — `ended` is tri-state across modes (null | bool). */
|
|
15
15
|
export interface RawLifeSpan {
|
|
16
16
|
begin?: string | null;
|
|
@@ -55,7 +55,7 @@ export interface RawRelation {
|
|
|
55
55
|
artist?: {
|
|
56
56
|
id?: string;
|
|
57
57
|
name?: string;
|
|
58
|
-
disambiguation?: string;
|
|
58
|
+
disambiguation?: string | null;
|
|
59
59
|
};
|
|
60
60
|
attributes?: string[];
|
|
61
61
|
begin?: string | null;
|
|
@@ -65,11 +65,13 @@ export interface RawRelation {
|
|
|
65
65
|
label?: {
|
|
66
66
|
id?: string;
|
|
67
67
|
name?: string;
|
|
68
|
+
disambiguation?: string | null;
|
|
68
69
|
};
|
|
70
|
+
'ordering-key'?: number | null;
|
|
69
71
|
recording?: {
|
|
70
72
|
id?: string;
|
|
71
73
|
title?: string;
|
|
72
|
-
disambiguation?: string;
|
|
74
|
+
disambiguation?: string | null;
|
|
73
75
|
};
|
|
74
76
|
'target-type'?: string;
|
|
75
77
|
type?: string;
|
|
@@ -81,7 +83,7 @@ export interface RawRelation {
|
|
|
81
83
|
work?: {
|
|
82
84
|
id?: string;
|
|
83
85
|
title?: string;
|
|
84
|
-
disambiguation?: string;
|
|
86
|
+
disambiguation?: string | null;
|
|
85
87
|
};
|
|
86
88
|
}
|
|
87
89
|
export interface RawArtist {
|
|
@@ -188,6 +190,7 @@ export interface RawRecording {
|
|
|
188
190
|
isrcs?: string[];
|
|
189
191
|
length?: number | null;
|
|
190
192
|
relations?: RawRelation[];
|
|
193
|
+
'release-count'?: number;
|
|
191
194
|
releases?: RawRelease[];
|
|
192
195
|
score?: number;
|
|
193
196
|
title?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjG,mFAAmF;AACnF,MAAM,MAAM,UAAU,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjG,mFAAmF;AACnF,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,OAAO,GACP,eAAe,GACf,SAAS,GACT,WAAW,GACX,MAAM,GACN,MAAM,CAAC;AAIX,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACvE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACxE;AAID,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,UAAU;IACzB,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,mBAAmB,CAAC,EAAE,eAAe,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qBAAqB,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAID;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,oGAAoG;AACpG,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Bounded work recording relationships shared by tool and resource views.
|
|
3
|
+
* @module services/musicbrainz/work-relations
|
|
4
|
+
*/
|
|
5
|
+
import type { RawRelation } from './types.js';
|
|
6
|
+
/** Exact recording relationship count and disclosure for an actual server-side slice. */
|
|
7
|
+
export interface RecordingRelationshipSummary {
|
|
8
|
+
cap?: number;
|
|
9
|
+
notice?: string;
|
|
10
|
+
shown?: number;
|
|
11
|
+
totalCount: number;
|
|
12
|
+
truncated?: true;
|
|
13
|
+
}
|
|
14
|
+
/** Keep the first 25 recording-target relations and every other relation, in upstream order. */
|
|
15
|
+
export declare function sliceWorkRelations(relations: RawRelation[] | undefined, mbid: string): {
|
|
16
|
+
relations: RawRelation[];
|
|
17
|
+
summary: RecordingRelationshipSummary;
|
|
18
|
+
};
|
|
19
|
+
//# sourceMappingURL=work-relations.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"work-relations.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/work-relations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,yFAAyF;AACzF,MAAM,WAAW,4BAA4B;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,gGAAgG;AAChG,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,WAAW,EAAE,GAAG,SAAS,EACpC,IAAI,EAAE,MAAM,GACX;IACD,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,EAAE,4BAA4B,CAAC;CACvC,CAsBA"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/** Keep the first 25 recording-target relations and every other relation, in upstream order. */
|
|
2
|
+
export function sliceWorkRelations(relations, mbid) {
|
|
3
|
+
const cap = 25;
|
|
4
|
+
let totalCount = 0;
|
|
5
|
+
const retained = (relations ?? []).filter((relation) => {
|
|
6
|
+
if (relation['target-type'] !== 'recording')
|
|
7
|
+
return true;
|
|
8
|
+
totalCount++;
|
|
9
|
+
return totalCount <= cap;
|
|
10
|
+
});
|
|
11
|
+
return {
|
|
12
|
+
relations: retained,
|
|
13
|
+
summary: {
|
|
14
|
+
totalCount,
|
|
15
|
+
...(totalCount > cap
|
|
16
|
+
? {
|
|
17
|
+
truncated: true,
|
|
18
|
+
shown: cap,
|
|
19
|
+
cap,
|
|
20
|
+
notice: `Showing ${cap} of ${totalCount} recording relationships. Call musicbrainz_browse_entities (target_type=recording, link.work=${mbid}, limit=25, offset=0) to enumerate recording entities, then musicbrainz_get_recording for each recording's work relationship attributes and dates. Browse does not return performance relationship details.`,
|
|
21
|
+
}
|
|
22
|
+
: {}),
|
|
23
|
+
},
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=work-relations.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"work-relations.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/work-relations.ts"],"names":[],"mappings":"AAeA,gGAAgG;AAChG,MAAM,UAAU,kBAAkB,CAChC,SAAoC,EACpC,IAAY;IAKZ,MAAM,GAAG,GAAG,EAAE,CAAC;IACf,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,QAAQ,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;QACrD,IAAI,QAAQ,CAAC,aAAa,CAAC,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QACzD,UAAU,EAAE,CAAC;QACb,OAAO,UAAU,IAAI,GAAG,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO;QACL,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE;YACP,UAAU;YACV,GAAG,CAAC,UAAU,GAAG,GAAG;gBAClB,CAAC,CAAC;oBACE,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,GAAG;oBACV,GAAG;oBACH,MAAM,EAAE,WAAW,GAAG,OAAO,UAAU,gGAAgG,IAAI,6MAA6M;iBACzV;gBACH,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;AACJ,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cyanheads/musicbrainz-mcp-server",
|
|
3
|
-
"version": "0.1
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"mcpName": "io.github.cyanheads/musicbrainz-mcp-server",
|
|
5
5
|
"description": "Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.",
|
|
6
6
|
"type": "module",
|
|
@@ -81,7 +81,7 @@
|
|
|
81
81
|
}
|
|
82
82
|
],
|
|
83
83
|
"license": "Apache-2.0",
|
|
84
|
-
"packageManager": "bun@1.4.
|
|
84
|
+
"packageManager": "bun@1.4.4",
|
|
85
85
|
"engines": {
|
|
86
86
|
"bun": ">=1.4.0",
|
|
87
87
|
"node": ">=24.0.0"
|
|
@@ -90,18 +90,18 @@
|
|
|
90
90
|
"access": "public"
|
|
91
91
|
},
|
|
92
92
|
"dependencies": {
|
|
93
|
-
"@cyanheads/mcp-ts-core": "^0.13.
|
|
93
|
+
"@cyanheads/mcp-ts-core": "^0.13.15",
|
|
94
94
|
"pino-pretty": "^13.2.0",
|
|
95
|
-
"zod": "^4.6.
|
|
95
|
+
"zod": "^4.6.7"
|
|
96
96
|
},
|
|
97
97
|
"devDependencies": {
|
|
98
98
|
"@biomejs/biome": "2.5.15",
|
|
99
99
|
"@socketsecurity/bun-security-scanner": "^1.1.3",
|
|
100
|
-
"@types/node": "26.6.
|
|
100
|
+
"@types/node": "26.6.5",
|
|
101
101
|
"depcheck": "^1.4.7",
|
|
102
|
-
"ignore": "^7.0.
|
|
103
|
-
"tsc-alias": "^1.9.
|
|
102
|
+
"ignore": "^7.0.13",
|
|
103
|
+
"tsc-alias": "^1.9.8",
|
|
104
104
|
"typescript": "^7.0.2",
|
|
105
|
-
"vitest": "^5.0.
|
|
105
|
+
"vitest": "^5.0.5"
|
|
106
106
|
}
|
|
107
107
|
}
|
package/server.json
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
"url": "https://github.com/cyanheads/musicbrainz-mcp-server",
|
|
7
7
|
"source": "github"
|
|
8
8
|
},
|
|
9
|
-
"version": "0.1
|
|
9
|
+
"version": "0.2.1",
|
|
10
10
|
"remotes": [
|
|
11
11
|
{
|
|
12
12
|
"type": "streamable-http",
|
|
@@ -19,8 +19,15 @@
|
|
|
19
19
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
20
20
|
"identifier": "@cyanheads/musicbrainz-mcp-server",
|
|
21
21
|
"runtimeHint": "npx",
|
|
22
|
-
"version": "0.1
|
|
22
|
+
"version": "0.2.1",
|
|
23
23
|
"environmentVariables": [
|
|
24
|
+
{
|
|
25
|
+
"name": "MUSICBRAINZ_CLAMP_OVERSIZED_LIMITS",
|
|
26
|
+
"description": "Clamp search/browse page limits above 100 with a notice; off restores maximum-100 validation.",
|
|
27
|
+
"format": "boolean",
|
|
28
|
+
"isRequired": false,
|
|
29
|
+
"default": "true"
|
|
30
|
+
},
|
|
24
31
|
{
|
|
25
32
|
"name": "MUSICBRAINZ_CONTACT",
|
|
26
33
|
"description": "Contact (email or URL) embedded in the mandatory descriptive MusicBrainz User-Agent. Not start-blocking — the server ships a default contact — but operators running a shared or hosted instance should set their own so MusicBrainz can reach them about traffic.",
|
|
@@ -44,8 +51,15 @@
|
|
|
44
51
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
45
52
|
"identifier": "@cyanheads/musicbrainz-mcp-server",
|
|
46
53
|
"runtimeHint": "npx",
|
|
47
|
-
"version": "0.1
|
|
54
|
+
"version": "0.2.1",
|
|
48
55
|
"environmentVariables": [
|
|
56
|
+
{
|
|
57
|
+
"name": "MUSICBRAINZ_CLAMP_OVERSIZED_LIMITS",
|
|
58
|
+
"description": "Clamp search/browse page limits above 100 with a notice; off restores maximum-100 validation.",
|
|
59
|
+
"format": "boolean",
|
|
60
|
+
"isRequired": false,
|
|
61
|
+
"default": "true"
|
|
62
|
+
},
|
|
49
63
|
{
|
|
50
64
|
"name": "MCP_TRANSPORT_TYPE",
|
|
51
65
|
"description": "Selects the HTTP transport.",
|