@cyanheads/musicbrainz-mcp-server 0.3.0 → 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.
- package/AGENTS.md +17 -9
- package/CLAUDE.md +17 -9
- package/README.md +13 -10
- package/changelog/0.4.x/0.4.0.md +31 -0
- package/changelog/template.md +10 -3
- 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 +21 -3
- package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
- package/dist/mcp-server/tools/definitions/_shared.d.ts +2 -2
- package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/_shared.js +13 -9
- package/dist/mcp-server/tools/definitions/_shared.js.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +22 -3
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js +31 -6
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +29 -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 +93 -6
- package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -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 +4 -4
- package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +16 -0
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release.tool.js +34 -29
- package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.js +3 -3
- package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +157 -56
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +18 -1
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +27 -3
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/release-edition.d.ts +44 -0
- package/dist/mcp-server/tools/definitions/release-edition.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/release-edition.js +143 -0
- package/dist/mcp-server/tools/definitions/release-edition.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +23 -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 +82 -22
- package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
- package/dist/services/musicbrainz/musicbrainz-service.d.ts +16 -3
- package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
- package/dist/services/musicbrainz/musicbrainz-service.js +8 -1
- package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
- package/dist/services/musicbrainz/types.d.ts +33 -2
- package/dist/services/musicbrainz/types.d.ts.map +1 -1
- package/package.json +6 -6
- package/server.json +3 -3
- package/skills/musicbrainz-guide/SKILL.md +8 -5
- package/skills/musicbrainz-guide/references/query-syntax.md +1 -0
|
@@ -7,8 +7,12 @@
|
|
|
7
7
|
* fabricating concrete values.
|
|
8
8
|
* @module services/musicbrainz/types
|
|
9
9
|
*/
|
|
10
|
-
/**
|
|
10
|
+
/** Entity types supported by lookup and browse. */
|
|
11
11
|
export type EntityType = 'artist' | 'release-group' | 'release' | 'recording' | 'work' | 'label';
|
|
12
|
+
/** Area adds name discovery without adding an area lookup or browse target. */
|
|
13
|
+
export type SearchEntityType = EntityType | 'area';
|
|
14
|
+
/** MusicBrainz's artist release-group browse visibility filter. */
|
|
15
|
+
export type ReleaseGroupStatus = 'website-default' | 'all';
|
|
12
16
|
/** Parent link types for the browse endpoint (one parent MBID per browse call). */
|
|
13
17
|
export type BrowseLink = 'artist' | 'track_artist' | 'label' | 'release-group' | 'release' | 'recording' | 'work' | 'area';
|
|
14
18
|
/** A life span / date range — `ended` is tri-state across modes (null | bool). */
|
|
@@ -35,6 +39,22 @@ export interface RawArea {
|
|
|
35
39
|
name?: string;
|
|
36
40
|
'sort-name'?: string;
|
|
37
41
|
}
|
|
42
|
+
/** Area search nests containment links in relation-list, unlike lookup relations. */
|
|
43
|
+
export interface RawAreaSearchHit extends RawArea {
|
|
44
|
+
disambiguation?: string | null;
|
|
45
|
+
id: string;
|
|
46
|
+
'iso-3166-2-codes'?: string[] | null;
|
|
47
|
+
'iso-3166-3-codes'?: string[] | null;
|
|
48
|
+
'relation-list'?: {
|
|
49
|
+
relations?: {
|
|
50
|
+
area?: RawArea | null;
|
|
51
|
+
direction?: string;
|
|
52
|
+
type?: string;
|
|
53
|
+
}[] | null;
|
|
54
|
+
}[] | null;
|
|
55
|
+
score?: number;
|
|
56
|
+
type?: string | null;
|
|
57
|
+
}
|
|
38
58
|
/** One credited artist within an artist-credit array; `joinphrase` stitches collaborations. */
|
|
39
59
|
export interface RawArtistCredit {
|
|
40
60
|
artist?: {
|
|
@@ -73,6 +93,11 @@ export interface RawRelation {
|
|
|
73
93
|
title?: string;
|
|
74
94
|
disambiguation?: string | null;
|
|
75
95
|
};
|
|
96
|
+
release?: {
|
|
97
|
+
id?: string;
|
|
98
|
+
title?: string;
|
|
99
|
+
disambiguation?: string | null;
|
|
100
|
+
};
|
|
76
101
|
'target-type'?: string;
|
|
77
102
|
type?: string;
|
|
78
103
|
'type-id'?: string;
|
|
@@ -176,6 +201,10 @@ export interface RawRelease {
|
|
|
176
201
|
packaging?: string | null;
|
|
177
202
|
'packaging-id'?: string | null;
|
|
178
203
|
relations?: RawRelation[];
|
|
204
|
+
'release-events'?: {
|
|
205
|
+
date?: string | null;
|
|
206
|
+
area?: RawArea | null;
|
|
207
|
+
}[];
|
|
179
208
|
'release-group'?: RawReleaseGroup;
|
|
180
209
|
score?: number;
|
|
181
210
|
status?: string | null;
|
|
@@ -185,6 +214,7 @@ export interface RawRelease {
|
|
|
185
214
|
script?: string | null;
|
|
186
215
|
};
|
|
187
216
|
title?: string;
|
|
217
|
+
'track-count'?: number;
|
|
188
218
|
}
|
|
189
219
|
export interface RawRecording {
|
|
190
220
|
'artist-credit'?: RawArtistCredit[];
|
|
@@ -241,10 +271,11 @@ export interface RawLabel {
|
|
|
241
271
|
}
|
|
242
272
|
/**
|
|
243
273
|
* Search response envelope. The entity array is keyed by the pluralized type
|
|
244
|
-
* (`artists`, `release-groups`, `releases`, `recordings`, `works`, `labels`).
|
|
274
|
+
* (`areas`, `artists`, `release-groups`, `releases`, `recordings`, `works`, `labels`).
|
|
245
275
|
* `count` is total matches; per-result `score` is 0–100 Lucene relevance.
|
|
246
276
|
*/
|
|
247
277
|
export interface SearchEnvelope {
|
|
278
|
+
areas?: RawAreaSearchHit[];
|
|
248
279
|
artists?: RawArtist[];
|
|
249
280
|
count?: number;
|
|
250
281
|
created?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cyanheads/musicbrainz-mcp-server",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
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",
|
|
@@ -84,25 +84,25 @@
|
|
|
84
84
|
"license": "Apache-2.0",
|
|
85
85
|
"packageManager": "bun@1.4.4",
|
|
86
86
|
"engines": {
|
|
87
|
-
"bun": ">=1.4.
|
|
87
|
+
"bun": ">=1.4.4",
|
|
88
88
|
"node": ">=24.0.0"
|
|
89
89
|
},
|
|
90
90
|
"publishConfig": {
|
|
91
91
|
"access": "public"
|
|
92
92
|
},
|
|
93
93
|
"dependencies": {
|
|
94
|
-
"@cyanheads/mcp-ts-core": "^0.13.
|
|
94
|
+
"@cyanheads/mcp-ts-core": "^0.13.22",
|
|
95
95
|
"pino-pretty": "^13.2.0",
|
|
96
96
|
"zod": "^4.6.7"
|
|
97
97
|
},
|
|
98
98
|
"devDependencies": {
|
|
99
|
-
"@biomejs/biome": "2.6.
|
|
99
|
+
"@biomejs/biome": "2.6.8",
|
|
100
100
|
"@socketsecurity/bun-security-scanner": "^1.1.3",
|
|
101
101
|
"@types/node": "26.6.6",
|
|
102
102
|
"depcheck": "^1.4.7",
|
|
103
|
-
"ignore": "^7.0.
|
|
103
|
+
"ignore": "^7.0.16",
|
|
104
104
|
"tsc-alias": "^1.9.10",
|
|
105
105
|
"typescript": "^7.0.2",
|
|
106
|
-
"vitest": "^5.
|
|
106
|
+
"vitest": "^5.1.1"
|
|
107
107
|
}
|
|
108
108
|
}
|
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.
|
|
9
|
+
"version": "0.4.0",
|
|
10
10
|
"remotes": [
|
|
11
11
|
{
|
|
12
12
|
"type": "streamable-http",
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
20
20
|
"identifier": "@cyanheads/musicbrainz-mcp-server",
|
|
21
21
|
"runtimeHint": "npx",
|
|
22
|
-
"version": "0.
|
|
22
|
+
"version": "0.4.0",
|
|
23
23
|
"environmentVariables": [
|
|
24
24
|
{
|
|
25
25
|
"name": "MUSICBRAINZ_CLAMP_OVERSIZED_LIMITS",
|
|
@@ -51,7 +51,7 @@
|
|
|
51
51
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
52
52
|
"identifier": "@cyanheads/musicbrainz-mcp-server",
|
|
53
53
|
"runtimeHint": "npx",
|
|
54
|
-
"version": "0.
|
|
54
|
+
"version": "0.4.0",
|
|
55
55
|
"environmentVariables": [
|
|
56
56
|
{
|
|
57
57
|
"name": "MUSICBRAINZ_CLAMP_OVERSIZED_LIMITS",
|
|
@@ -4,7 +4,7 @@ description: Resolve music identities and follow musicbrainz_* tools across disc
|
|
|
4
4
|
license: Apache-2.0
|
|
5
5
|
metadata:
|
|
6
6
|
author: "cyanheads"
|
|
7
|
-
version: "1.
|
|
7
|
+
version: "1.1"
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
## Scope
|
|
@@ -23,10 +23,11 @@ Choose the entity before resolving its name:
|
|
|
23
23
|
| Recording | Recorded audio that can appear on multiple releases | Recording search, release track's recording link, ISRC lookup, work relationships |
|
|
24
24
|
| Work | A composition, including movements or arrangements | Work search, recording's work relationships, ISWC lookup |
|
|
25
25
|
| Label | A music label | Label search, release label information, relationship targets |
|
|
26
|
+
| Area | A geographic entity used as a browse parent | Area search, artist or label area references |
|
|
26
27
|
|
|
27
28
|
`musicbrainz_lookup_identifier` resolves ISRCs to recordings, ISWCs to works, and barcodes to releases. Keep each returned MBID's entity type attached to it; identical UUID syntax does not make types interchangeable. Preserve identifiers as strings, including leading zeros.
|
|
28
29
|
|
|
29
|
-
|
|
30
|
+
Use an area MBID for `link.area`. Resolve a geographic name with area search, or reuse a known artist or label’s `areaId`. IPI/ISNI identify people or organizations, while a work's society attributes identify that composition in a society's catalog.
|
|
30
31
|
|
|
31
32
|
## Gates
|
|
32
33
|
|
|
@@ -44,9 +45,9 @@ Resolve a name with `musicbrainz_search_entities`, or a supplied standard identi
|
|
|
44
45
|
|
|
45
46
|
### Discography and editions
|
|
46
47
|
|
|
47
|
-
For an artist's albums, resolve the artist
|
|
48
|
+
For an artist's albums, resolve the artist and browse release-groups by `link.artist` with `type=album`. Add `release_group_status=website-default` when the question calls for the discography shown on MusicBrainz’s artist page. Omit the filter for the full catalog, including bootleg-only groups. “Album” alone does not establish a studio album: live albums and compilations can share that primary type. Missing secondary types mean unclassified metadata, so qualify uncertain classifications. Keep the applied filters when continuing; pipe-separated type filters do not universally mean “either,” so follow the tool's category semantics.
|
|
48
49
|
|
|
49
|
-
For a particular pressing,
|
|
50
|
+
For a particular pressing, compare the returned catalog numbers, formats, barcode, and release events across the group’s releases or a barcode search. One edition can have several country/date events. Open the matching edition with `musicbrainz_get_release`. Retrieve remaining media before reporting a complete tracklist. Recording enumeration cannot reconstruct ordered track occurrences, including repeated appearances of the same recording.
|
|
50
51
|
|
|
51
52
|
### Track credits and compositions
|
|
52
53
|
|
|
@@ -54,9 +55,11 @@ For a named track on an edition, start from `musicbrainz_get_release` and use th
|
|
|
54
55
|
|
|
55
56
|
For performances of a composition, resolve the work, browse its recordings, and retrieve recording details where the question needs performance dates or relationship attributes. For classical parts, follow work targets and retain ordering keys and direction; do not sort movements by title or treat an arrangement as the same work without checking the relationship.
|
|
56
57
|
|
|
58
|
+
For an engineer or producer’s credits, resolve the artist and request `credits=release` or `credits=recording` with `musicbrainz_get_artist`. Use `credit_types=producer|engineer|mix` to limit roles. Page the filtered results before reporting the artist’s credited catalog. For the reverse lookup, inspect the selected edition’s relationships for mastering, design, pressing, and label credits. Work relationships identify cataloged publishers, and recording relationships can identify a phonographic copyright credit.
|
|
59
|
+
|
|
57
60
|
For society registrations, inspect work attributes, then follow the writer/composer's artist MBID for IPI/ISNI. Preserve repeated society entries and their string values. These are catalog identifiers, not a determination of current ownership or licensing authority.
|
|
58
61
|
|
|
59
|
-
For labels or artists in
|
|
62
|
+
For labels or artists in a named city, search `entityType=area` with a query such as `area:portland`. Use `partOf`, area type, disambiguation, and any ISO codes to choose the intended place. Pass its MBID as `link.area` to browse.
|
|
60
63
|
|
|
61
64
|
### Artwork and external identities
|
|
62
65
|
|
|
@@ -15,6 +15,7 @@ Use these expressions with `musicbrainz_search_entities`. Choose the entity inde
|
|
|
15
15
|
| Recording | `recording:"Creep" AND arid:a74b1b7f-71a5-4011-9441-d0b5e4122711` |
|
|
16
16
|
| Work | `work:"Bohemian Rhapsody"` |
|
|
17
17
|
| Label | `label:"Warp" AND country:GB` |
|
|
18
|
+
| Area | `area:seattle` |
|
|
18
19
|
|
|
19
20
|
`arid` is an artist MBID; `rgid` is a release-group MBID. Replace example IDs with the identity resolved for the task. Search `primarytype` and `secondarytype` are distinct fields; browse filters have their own schema and do not accept Lucene expressions. Recording `firstreleasedate` concerns earliest release, not recording-session time.
|
|
20
21
|
|