@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.
- package/AGENTS.md +36 -10
- package/CLAUDE.md +36 -10
- package/Dockerfile +3 -0
- package/README.md +49 -108
- package/changelog/0.3.x/0.3.0.md +33 -0
- package/changelog/0.4.x/0.4.0.md +31 -0
- package/changelog/template.md +10 -3
- package/dist/index.js +2 -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 +32 -6
- package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
- package/dist/mcp-server/tools/definitions/_pagination.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/_pagination.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/_pagination.js +7 -1
- package/dist/mcp-server/tools/definitions/_pagination.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 +33 -2
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js +120 -9
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +40 -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 +145 -6
- package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +15 -0
- package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-label.tool.js +28 -4
- package/dist/mcp-server/tools/definitions/get-label.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 +5 -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 +4 -0
- 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 +9 -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 +27 -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 +51 -27
- package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +5 -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 +32 -4
- package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +168 -3
- 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 +30 -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 +115 -24
- package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
- package/dist/services/musicbrainz/musicbrainz-service.d.ts +20 -3
- package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
- package/dist/services/musicbrainz/musicbrainz-service.js +12 -1
- package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
- package/dist/services/musicbrainz/types.d.ts +40 -3
- package/dist/services/musicbrainz/types.d.ts.map +1 -1
- package/package.json +9 -8
- package/server.json +3 -3
- package/skills/musicbrainz-guide/SKILL.md +72 -0
- package/skills/musicbrainz-guide/references/query-syntax.md +24 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"musicbrainz-service.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EACL,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,qBAAqB,EACrB,SAAS,GACV,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"musicbrainz-service.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EACL,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,qBAAqB,EACrB,SAAS,GACV,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAYhD;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAC,MAAc,EAAE,IAAY;IAC5C,OAAO,GAAG,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,2DAA2D;AAC3D,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,gBAAgB;IACjC,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,YAAY;IACvB,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,QAAQ;CACkD,CAAC;AAyBpE;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAIV,OAAO;IAGP,OAAO;IACP,eAAe;IACf,SAAS;IACT,UAAU;IATZ,SAAS,CAAS;IAEnC,YACmB,OAAe,EAChC,OAAe,EACf,OAAe,EACE,OAAoB,EACpB,eAAuB,EACvB,SAAiB,EACjB,UAAkB;uBANlB,OAAO;uBAGP,OAAO;+BACP,eAAe;yBACf,SAAS;0BACT,UAAU;QAE3B,IAAI,CAAC,SAAS,GAAG,0BAA0B,OAAO,MAAM,OAAO,IAAI,CAAC;IACtE,CAAC;IAED,oFAAoF;IACpF,MAAM,CACJ,IAAsB,EACtB,KAAa,EACb,MAAoB,EACpB,GAAY,EACZ,OAAqB;QAErB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,KAAK;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7B,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CACjB,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,EAC/B,GAAG,EACH,OAAO,EACP,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CACjD,CAAC;IACJ,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,MAAM,CACV,IAAgB,EAChB,IAAY,EACZ,MAAoB,EACpB,GAAY,EACZ,OAAqB;QAErB,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,OAAO,MAAM,IAAI,CAAC,OAAO,CAAI,IAAI,IAAI,IAAI,cAAc,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAChG,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,MAAM,CACV,MAAS,EACT,MAAoB,EACpB,GAAY,EACZ,OAAqB;QAErB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7B,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,4CAA4C,CAAC,CAAC;QAClE,CAAC;aAAM,IAAI,MAAM,KAAK,eAAe,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAChE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,MAAM,CAAC,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,OAAO,CACvB,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,EACjC,GAAG,EACH,OAAO,EACP,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,MAAM,QAAQ,CAAC,CAAC,CAC9D,CAAC;IACJ,CAAC;IAED,2EAA2E;IACnE,aAAa,CAAC,KAAc;QAClC,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvB,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;YACxB,KAAK,GAAG,CAAC,EACT,CAAC;YACD,MAAM,kBAAkB,CACtB,kGAAkG,EAClG;gBACE,MAAM,EAAE,gCAAgC;gBACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,gEAAgE,EAAE;aACrF,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,KAAa,EAAE,GAAY,EAAE,OAAqB;QAC5D,OAAO,IAAI,CAAC,OAAO,CACjB,SAAS,kBAAkB,CAAC,KAAK,CAAC,8BAA8B,EAChE,GAAG,EACH,OAAO,CACR,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,GAAY,EAAE,OAAqB;QAC5D,uFAAuF;QACvF,OAAO,IAAI,CAAC,OAAO,CACjB,SAAS,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAC7C,GAAG,EACH,OAAO,CACR,CAAC;IACJ,CAAC;IAED,8FAA8F;IAC9F,MAAM,CAAC,SAAS,CAA6B,IAAO;QAClD,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;OAWG;IACK,KAAK,CAAC,OAAO,CACnB,IAAY,EACZ,GAAY,EACZ,OAAqB,EACrB,QAA8B;QAE9B,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;YAC3C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjD,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACxD,SAAS,EAAE,oBAAoB;YAC/B,aAAa,EAAE,GAAG;SACnB,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACjF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAErF,IAAI,MAAS,CAAC;QACd,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,SAAS,CACtB,GAAG,EAAE,CACH,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;gBAC/B,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE;oBAC9D,OAAO,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE;oBACrE,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;iBACnD,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC,KAAK,CAAI,IAAI,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EACrB;gBACE,SAAS,EAAE,oBAAoB;gBAC/B,OAAO,EAAE,MAAM;gBACf,WAAW,EAAE,IAAI,EAAE,8CAA8C;gBACjE,UAAU;gBACV,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;aACnD,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,aAAa,EAAE,CAAC;gBAC/E,MAAM,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;QACnB,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAI,IAAY,EAAE,IAAY;QACzC,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,kBAAkB,CACtB,sFAAsF,EACtF,EAAE,MAAM,EAAE,2BAA2B,EAAE,IAAI,EAAE,CAC9C,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,oEAAoE;YACpE,wDAAwD;YACxD,MAAM,kBAAkB,CACtB,iDAAiD,EACjD,EAAE,MAAM,EAAE,4BAA4B,EAAE,IAAI,EAAE,EAC9C,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,gFAAgF;AAEhF,IAAI,QAAwC,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACrD,QAAQ,GAAG,IAAI,kBAAkB,CAC/B,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,OAAO,EACd,OAAO,EACP,OAAO,EACP,MAAM,CAAC,eAAe,EACtB,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,UAAU,CAClB,CAAC;IACF,MAAM,CAAC,IAAI,CACT,kCAAkC,EAClC,qBAAqB,CAAC,oBAAoB,CAAC;QACzC,SAAS,EAAE,iBAAiB;QAC5B,iBAAiB,EAAE;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,uBAAuB;IACrC,QAAQ,GAAG,SAAS,CAAC;AACvB,CAAC"}
|
|
@@ -7,10 +7,14 @@
|
|
|
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
|
-
export type BrowseLink = 'artist' | 'label' | 'release-group' | 'release' | 'recording' | 'work' | 'area';
|
|
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). */
|
|
15
19
|
export interface RawLifeSpan {
|
|
16
20
|
begin?: string | null;
|
|
@@ -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;
|
|
@@ -92,9 +117,12 @@ export interface RawArtist {
|
|
|
92
117
|
'begin-area'?: RawArea | null;
|
|
93
118
|
country?: string | null;
|
|
94
119
|
disambiguation?: string;
|
|
120
|
+
'end-area'?: RawArea | null;
|
|
95
121
|
gender?: string | null;
|
|
96
122
|
genres?: RawTag[];
|
|
97
123
|
id: string;
|
|
124
|
+
ipis?: string[];
|
|
125
|
+
isnis?: string[];
|
|
98
126
|
'life-span'?: RawLifeSpan;
|
|
99
127
|
name?: string;
|
|
100
128
|
relations?: RawRelation[];
|
|
@@ -134,6 +162,7 @@ export interface RawCoverArtStub {
|
|
|
134
162
|
front?: boolean;
|
|
135
163
|
}
|
|
136
164
|
export interface RawTrack {
|
|
165
|
+
'artist-credit'?: RawArtistCredit[];
|
|
137
166
|
id?: string;
|
|
138
167
|
length?: number | null;
|
|
139
168
|
number?: string;
|
|
@@ -172,6 +201,10 @@ export interface RawRelease {
|
|
|
172
201
|
packaging?: string | null;
|
|
173
202
|
'packaging-id'?: string | null;
|
|
174
203
|
relations?: RawRelation[];
|
|
204
|
+
'release-events'?: {
|
|
205
|
+
date?: string | null;
|
|
206
|
+
area?: RawArea | null;
|
|
207
|
+
}[];
|
|
175
208
|
'release-group'?: RawReleaseGroup;
|
|
176
209
|
score?: number;
|
|
177
210
|
status?: string | null;
|
|
@@ -181,6 +214,7 @@ export interface RawRelease {
|
|
|
181
214
|
script?: string | null;
|
|
182
215
|
};
|
|
183
216
|
title?: string;
|
|
217
|
+
'track-count'?: number;
|
|
184
218
|
}
|
|
185
219
|
export interface RawRecording {
|
|
186
220
|
'artist-credit'?: RawArtistCredit[];
|
|
@@ -223,6 +257,8 @@ export interface RawLabel {
|
|
|
223
257
|
disambiguation?: string;
|
|
224
258
|
genres?: RawTag[];
|
|
225
259
|
id: string;
|
|
260
|
+
ipis?: string[];
|
|
261
|
+
isnis?: string[];
|
|
226
262
|
'label-code'?: number | null;
|
|
227
263
|
'life-span'?: RawLifeSpan;
|
|
228
264
|
name?: string;
|
|
@@ -235,10 +271,11 @@ export interface RawLabel {
|
|
|
235
271
|
}
|
|
236
272
|
/**
|
|
237
273
|
* Search response envelope. The entity array is keyed by the pluralized type
|
|
238
|
-
* (`artists`, `release-groups`, `releases`, `recordings`, `works`, `labels`).
|
|
274
|
+
* (`areas`, `artists`, `release-groups`, `releases`, `recordings`, `works`, `labels`).
|
|
239
275
|
* `count` is total matches; per-result `score` is 0–100 Lucene relevance.
|
|
240
276
|
*/
|
|
241
277
|
export interface SearchEnvelope {
|
|
278
|
+
areas?: RawAreaSearchHit[];
|
|
242
279
|
artists?: RawArtist[];
|
|
243
280
|
count?: number;
|
|
244
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",
|
|
@@ -11,6 +11,7 @@
|
|
|
11
11
|
},
|
|
12
12
|
"files": [
|
|
13
13
|
"changelog/",
|
|
14
|
+
"skills/",
|
|
14
15
|
"dist/",
|
|
15
16
|
"!dist/*.mcpb",
|
|
16
17
|
"README.md",
|
|
@@ -83,25 +84,25 @@
|
|
|
83
84
|
"license": "Apache-2.0",
|
|
84
85
|
"packageManager": "bun@1.4.4",
|
|
85
86
|
"engines": {
|
|
86
|
-
"bun": ">=1.4.
|
|
87
|
+
"bun": ">=1.4.4",
|
|
87
88
|
"node": ">=24.0.0"
|
|
88
89
|
},
|
|
89
90
|
"publishConfig": {
|
|
90
91
|
"access": "public"
|
|
91
92
|
},
|
|
92
93
|
"dependencies": {
|
|
93
|
-
"@cyanheads/mcp-ts-core": "^0.13.
|
|
94
|
+
"@cyanheads/mcp-ts-core": "^0.13.22",
|
|
94
95
|
"pino-pretty": "^13.2.0",
|
|
95
96
|
"zod": "^4.6.7"
|
|
96
97
|
},
|
|
97
98
|
"devDependencies": {
|
|
98
|
-
"@biomejs/biome": "2.
|
|
99
|
+
"@biomejs/biome": "2.6.8",
|
|
99
100
|
"@socketsecurity/bun-security-scanner": "^1.1.3",
|
|
100
|
-
"@types/node": "26.6.
|
|
101
|
+
"@types/node": "26.6.6",
|
|
101
102
|
"depcheck": "^1.4.7",
|
|
102
|
-
"ignore": "^7.0.
|
|
103
|
-
"tsc-alias": "^1.9.
|
|
103
|
+
"ignore": "^7.0.16",
|
|
104
|
+
"tsc-alias": "^1.9.10",
|
|
104
105
|
"typescript": "^7.0.2",
|
|
105
|
-
"vitest": "^5.
|
|
106
|
+
"vitest": "^5.1.1"
|
|
106
107
|
}
|
|
107
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",
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: musicbrainz-guide
|
|
3
|
+
description: Resolve music identities and follow musicbrainz_* tools across discographies, editions, tracklists, recordings, compositions, credits, and artwork. Use for multi-step music metadata research, ISRC/ISWC/barcode resolution, or MusicBrainz Lucene queries.
|
|
4
|
+
license: Apache-2.0
|
|
5
|
+
metadata:
|
|
6
|
+
author: "cyanheads"
|
|
7
|
+
version: "1.1"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Scope
|
|
11
|
+
|
|
12
|
+
Use MusicBrainz for music identities, discographies, edition metadata, credits, relationships, and Cover Art Archive image links. Access is keyless and read-only. Audio playback, audio fingerprint recognition, catalog editing, and licensing clearance are outside this server's surface.
|
|
13
|
+
|
|
14
|
+
## Identifiers
|
|
15
|
+
|
|
16
|
+
Choose the entity before resolving its name:
|
|
17
|
+
|
|
18
|
+
| Entity | Represents | Where its MBID comes from |
|
|
19
|
+
|:---|:---|:---|
|
|
20
|
+
| Artist | A person, group, or other credited artist | Artist search, artist credits, relationship targets |
|
|
21
|
+
| Release-group | An album/single across its editions | Release-group search, artist discography, release's parent group |
|
|
22
|
+
| Release | A specific edition | Release search, group's editions, recording's appearances, barcode lookup |
|
|
23
|
+
| Recording | Recorded audio that can appear on multiple releases | Recording search, release track's recording link, ISRC lookup, work relationships |
|
|
24
|
+
| Work | A composition, including movements or arrangements | Work search, recording's work relationships, ISWC lookup |
|
|
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 |
|
|
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.
|
|
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.
|
|
31
|
+
|
|
32
|
+
## Gates
|
|
33
|
+
|
|
34
|
+
1. Confirm the intended identity before traversing: compare credited artist, disambiguation, dates, and edition evidence. A high search score or standard identifier can still yield several candidates; do not silently choose the first.
|
|
35
|
+
2. Before saying “all” or “none,” establish coverage with the appropriate browse and continuation notices. Embedded discographies, editions, release appearances, and work recording relationships can be partial. A failed call or an unrequested relationship is not evidence of absence.
|
|
36
|
+
3. Select a release edition before attributing its date, label, barcode, track order, or artwork to the user's copy. A release-group's first-release date and representative artwork describe the group, not every edition.
|
|
37
|
+
4. Preserve relationship direction and attributes when reporting credits, movements, and arrangements. Browse supplies entity identities; obtain recording relationship details before making performance-specific claims.
|
|
38
|
+
5. Report missing catalog facts as missing. Community metadata and external links do not establish current copyright ownership or permission to reuse an image or recording.
|
|
39
|
+
|
|
40
|
+
## Core chain
|
|
41
|
+
|
|
42
|
+
Resolve a name with `musicbrainz_search_entities`, or a supplied standard identifier with `musicbrainz_lookup_identifier`. Check the candidates, then call the matching `musicbrainz_get_*` tool. Follow returned MBIDs and typed relationships for the next hop; use `musicbrainz_browse_entities` when the task needs the linked set rather than a detail preview.
|
|
43
|
+
|
|
44
|
+
## Workflows
|
|
45
|
+
|
|
46
|
+
### Discography and editions
|
|
47
|
+
|
|
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.
|
|
49
|
+
|
|
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.
|
|
51
|
+
|
|
52
|
+
### Track credits and compositions
|
|
53
|
+
|
|
54
|
+
For a named track on an edition, start from `musicbrainz_get_release` and use the track's own artist credit. A release credit such as “Various Artists” does not identify the performer of each track. Follow its recording MBID to `musicbrainz_get_recording` for performance relationships, then the work relationship to `musicbrainz_get_work` for writers/composers, ISWCs, movements, or arrangements. A recording credit does not replace a missing edition-specific track credit, and the work's writer is not automatically its performer.
|
|
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.
|
|
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
|
+
|
|
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.
|
|
61
|
+
|
|
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.
|
|
63
|
+
|
|
64
|
+
### Artwork and external identities
|
|
65
|
+
|
|
66
|
+
Use `musicbrainz_get_cover_art` for the selected release's image URLs. Use group artwork only when representative artwork satisfies the task. Inspect full-archive availability and notices before treating an empty image page as no artwork.
|
|
67
|
+
|
|
68
|
+
Follow returned external links for cross-database identities. Keep the originating entity attached: an album group and one edition can link to different external records. Do not manufacture a Discogs identifier or Wikidata QID from a title match.
|
|
69
|
+
|
|
70
|
+
## References
|
|
71
|
+
|
|
72
|
+
- [Lucene query syntax and entity-specific examples](references/query-syntax.md)
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# MusicBrainz query syntax
|
|
2
|
+
|
|
3
|
+
Use these expressions with `musicbrainz_search_entities`. Choose the entity index first; fields differ by index.
|
|
4
|
+
|
|
5
|
+
- Quote phrases: `recording:"Bohemian Rhapsody"`.
|
|
6
|
+
- Write Boolean operators in uppercase and group alternatives: `artist:(Radiohead OR "Thom Yorke") AND recording:"Creep"`.
|
|
7
|
+
- Escape literal query punctuation with a backslash. Inside JSON, encode that backslash as `\\`; for example, a literal `+` becomes `\\+` in the JSON string.
|
|
8
|
+
- Start with a quoted title and credited artist; refine with a resolved artist MBID when names collide.
|
|
9
|
+
|
|
10
|
+
| Index | Example expression |
|
|
11
|
+
|:---|:---|
|
|
12
|
+
| Artist | `artist:"Björk" AND country:IS` |
|
|
13
|
+
| Release-group | `releasegroup:"OK Computer" AND primarytype:album` |
|
|
14
|
+
| Release | `release:"OK Computer" AND country:JP AND format:CD` |
|
|
15
|
+
| Recording | `recording:"Creep" AND arid:a74b1b7f-71a5-4011-9441-d0b5e4122711` |
|
|
16
|
+
| Work | `work:"Bohemian Rhapsody"` |
|
|
17
|
+
| Label | `label:"Warp" AND country:GB` |
|
|
18
|
+
| Area | `area:seattle` |
|
|
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.
|
|
21
|
+
|
|
22
|
+
Search exposes at most the first 500 matches. Narrow broad queries; use browse for complete linked sets. `totalCount` can exceed the accessible search window.
|
|
23
|
+
|
|
24
|
+
Sources: [MusicBrainz indexed search and fields](https://musicbrainz.org/doc/Indexed_Search_Syntax), [search window](https://musicbrainz.org/doc/Search), and [Lucene Boolean grouping and escaping](https://lucene.apache.org/core/3_6_2/queryparsersyntax.html).
|