@cyanheads/musicbrainz-mcp-server 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/AGENTS.md +466 -0
  2. package/CLAUDE.md +466 -0
  3. package/Dockerfile +121 -0
  4. package/LICENSE +201 -0
  5. package/README.md +329 -0
  6. package/changelog/0.1.x/0.1.0.md +27 -0
  7. package/changelog/template.md +127 -0
  8. package/dist/config/server-config.d.ts +24 -0
  9. package/dist/config/server-config.d.ts.map +1 -0
  10. package/dist/config/server-config.js +90 -0
  11. package/dist/config/server-config.js.map +1 -0
  12. package/dist/index.d.ts +10 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +27 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/mcp-server/resources/definitions/entity.resource.d.ts +33 -0
  17. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -0
  18. package/dist/mcp-server/resources/definitions/entity.resource.js +72 -0
  19. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -0
  20. package/dist/mcp-server/resources/definitions/index.d.ts +27 -0
  21. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  22. package/dist/mcp-server/resources/definitions/index.js +8 -0
  23. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  24. package/dist/mcp-server/tools/definitions/_shared.d.ts +105 -0
  25. package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -0
  26. package/dist/mcp-server/tools/definitions/_shared.js +382 -0
  27. package/dist/mcp-server/tools/definitions/_shared.js.map +1 -0
  28. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +62 -0
  29. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -0
  30. package/dist/mcp-server/tools/definitions/browse-entities.tool.js +236 -0
  31. package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -0
  32. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +78 -0
  33. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -0
  34. package/dist/mcp-server/tools/definitions/get-artist.tool.js +200 -0
  35. package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -0
  36. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +42 -0
  37. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -0
  38. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +149 -0
  39. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -0
  40. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +52 -0
  41. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -0
  42. package/dist/mcp-server/tools/definitions/get-label.tool.js +110 -0
  43. package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -0
  44. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +58 -0
  45. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -0
  46. package/dist/mcp-server/tools/definitions/get-recording.tool.js +135 -0
  47. package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -0
  48. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +55 -0
  49. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -0
  50. package/dist/mcp-server/tools/definitions/get-release-group.tool.js +140 -0
  51. package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -0
  52. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +66 -0
  53. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -0
  54. package/dist/mcp-server/tools/definitions/get-release.tool.js +213 -0
  55. package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -0
  56. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +62 -0
  57. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -0
  58. package/dist/mcp-server/tools/definitions/get-work.tool.js +132 -0
  59. package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -0
  60. package/dist/mcp-server/tools/definitions/index.d.ts +468 -0
  61. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  62. package/dist/mcp-server/tools/definitions/index.js +28 -0
  63. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  64. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +59 -0
  65. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -0
  66. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +214 -0
  67. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -0
  68. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +42 -0
  69. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -0
  70. package/dist/mcp-server/tools/definitions/search-entities.tool.js +187 -0
  71. package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -0
  72. package/dist/services/cover-art/cover-art-service.d.ts +40 -0
  73. package/dist/services/cover-art/cover-art-service.d.ts.map +1 -0
  74. package/dist/services/cover-art/cover-art-service.js +118 -0
  75. package/dist/services/cover-art/cover-art-service.js.map +1 -0
  76. package/dist/services/musicbrainz/musicbrainz-service.d.ts +81 -0
  77. package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -0
  78. package/dist/services/musicbrainz/musicbrainz-service.js +188 -0
  79. package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -0
  80. package/dist/services/musicbrainz/rate-limiter.d.ts +32 -0
  81. package/dist/services/musicbrainz/rate-limiter.d.ts.map +1 -0
  82. package/dist/services/musicbrainz/rate-limiter.js +54 -0
  83. package/dist/services/musicbrainz/rate-limiter.js.map +1 -0
  84. package/dist/services/musicbrainz/types.d.ts +301 -0
  85. package/dist/services/musicbrainz/types.d.ts.map +1 -0
  86. package/dist/services/musicbrainz/types.js +11 -0
  87. package/dist/services/musicbrainz/types.js.map +1 -0
  88. package/package.json +103 -0
  89. package/server.json +111 -0
@@ -0,0 +1,301 @@
1
+ /**
2
+ * @fileoverview Domain types for the MusicBrainz Web Service v2. Raw types model
3
+ * the upstream JSON shapes as they actually arrive — sparse and optional-heavy,
4
+ * since MusicBrainz omits fields entirely (and a field can present differently
5
+ * between search and lookup, e.g. `life-span.ended` is `null` from search but
6
+ * `false` from lookup). Normalization preserves absence as "unknown" rather than
7
+ * fabricating concrete values.
8
+ * @module services/musicbrainz/types
9
+ */
10
+ /** The six core entity types addressable by MBID across search, lookup, and browse. */
11
+ export type EntityType = 'artist' | 'release-group' | 'release' | 'recording' | 'work' | 'label';
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';
14
+ /** A life span / date range — `ended` is tri-state across modes (null | bool). */
15
+ export interface RawLifeSpan {
16
+ begin?: string | null;
17
+ end?: string | null;
18
+ ended?: boolean | null;
19
+ }
20
+ export interface RawAlias {
21
+ locale?: string | null;
22
+ name?: string;
23
+ primary?: boolean | null;
24
+ 'sort-name'?: string;
25
+ type?: string | null;
26
+ }
27
+ /** A genre or folksonomy tag with an upstream vote count. */
28
+ export interface RawTag {
29
+ count?: number;
30
+ name?: string;
31
+ }
32
+ export interface RawArea {
33
+ id?: string;
34
+ 'iso-3166-1-codes'?: string[];
35
+ name?: string;
36
+ 'sort-name'?: string;
37
+ }
38
+ /** One credited artist within an artist-credit array; `joinphrase` stitches collaborations. */
39
+ export interface RawArtistCredit {
40
+ artist?: {
41
+ id?: string;
42
+ name?: string;
43
+ 'sort-name'?: string;
44
+ disambiguation?: string;
45
+ };
46
+ joinphrase?: string;
47
+ name?: string;
48
+ }
49
+ /**
50
+ * A relationship in a lookup payload's `relations[]`, grouped by `target-type`.
51
+ * The nested target entity is keyed by its type (`artist` | `url` | `work` |
52
+ * `recording` | ...), so we model the common ones explicitly.
53
+ */
54
+ export interface RawRelation {
55
+ artist?: {
56
+ id?: string;
57
+ name?: string;
58
+ disambiguation?: string;
59
+ };
60
+ attributes?: string[];
61
+ begin?: string | null;
62
+ direction?: string;
63
+ end?: string | null;
64
+ ended?: boolean | null;
65
+ label?: {
66
+ id?: string;
67
+ name?: string;
68
+ };
69
+ recording?: {
70
+ id?: string;
71
+ title?: string;
72
+ disambiguation?: string;
73
+ };
74
+ 'target-type'?: string;
75
+ type?: string;
76
+ 'type-id'?: string;
77
+ url?: {
78
+ id?: string;
79
+ resource?: string;
80
+ };
81
+ work?: {
82
+ id?: string;
83
+ title?: string;
84
+ disambiguation?: string;
85
+ };
86
+ }
87
+ export interface RawArtist {
88
+ aliases?: RawAlias[];
89
+ area?: RawArea | null;
90
+ 'begin-area'?: RawArea | null;
91
+ country?: string | null;
92
+ disambiguation?: string;
93
+ gender?: string | null;
94
+ genres?: RawTag[];
95
+ id: string;
96
+ 'life-span'?: RawLifeSpan;
97
+ name?: string;
98
+ relations?: RawRelation[];
99
+ 'release-groups'?: RawReleaseGroup[];
100
+ score?: number;
101
+ 'sort-name'?: string;
102
+ tags?: RawTag[];
103
+ type?: string | null;
104
+ 'type-id'?: string | null;
105
+ }
106
+ export interface RawReleaseGroup {
107
+ 'artist-credit'?: RawArtistCredit[];
108
+ 'cover-art-archive'?: RawCoverArtStub;
109
+ disambiguation?: string;
110
+ 'first-release-date'?: string;
111
+ genres?: RawTag[];
112
+ id: string;
113
+ 'primary-type'?: string | null;
114
+ 'primary-type-id'?: string | null;
115
+ relations?: RawRelation[];
116
+ releases?: RawRelease[];
117
+ score?: number;
118
+ 'secondary-types'?: string[];
119
+ tags?: RawTag[];
120
+ title?: string;
121
+ }
122
+ /** The free `cover-art-archive` stub folded into release / release-group payloads. */
123
+ export interface RawCoverArtStub {
124
+ artwork?: boolean;
125
+ back?: boolean;
126
+ count?: number;
127
+ darkened?: boolean;
128
+ front?: boolean;
129
+ }
130
+ export interface RawTrack {
131
+ id?: string;
132
+ length?: number | null;
133
+ number?: string;
134
+ position?: number;
135
+ recording?: RawRecording;
136
+ title?: string;
137
+ }
138
+ export interface RawMedium {
139
+ format?: string | null;
140
+ 'format-id'?: string | null;
141
+ position?: number;
142
+ title?: string;
143
+ 'track-count'?: number;
144
+ 'track-offset'?: number;
145
+ tracks?: RawTrack[];
146
+ }
147
+ export interface RawLabelInfo {
148
+ 'catalog-number'?: string | null;
149
+ label?: {
150
+ id?: string;
151
+ name?: string;
152
+ 'label-code'?: number | null;
153
+ disambiguation?: string;
154
+ } | null;
155
+ }
156
+ export interface RawRelease {
157
+ 'artist-credit'?: RawArtistCredit[];
158
+ barcode?: string | null;
159
+ country?: string | null;
160
+ 'cover-art-archive'?: RawCoverArtStub;
161
+ date?: string;
162
+ disambiguation?: string;
163
+ id: string;
164
+ 'label-info'?: RawLabelInfo[];
165
+ media?: RawMedium[];
166
+ packaging?: string | null;
167
+ 'packaging-id'?: string | null;
168
+ relations?: RawRelation[];
169
+ 'release-group'?: RawReleaseGroup;
170
+ score?: number;
171
+ status?: string | null;
172
+ 'status-id'?: string | null;
173
+ 'text-representation'?: {
174
+ language?: string | null;
175
+ script?: string | null;
176
+ };
177
+ title?: string;
178
+ }
179
+ export interface RawRecording {
180
+ 'artist-credit'?: RawArtistCredit[];
181
+ disambiguation?: string;
182
+ 'first-release-date'?: string;
183
+ id: string;
184
+ isrcs?: string[];
185
+ length?: number | null;
186
+ relations?: RawRelation[];
187
+ releases?: RawRelease[];
188
+ score?: number;
189
+ title?: string;
190
+ video?: boolean | null;
191
+ }
192
+ export interface RawWork {
193
+ aliases?: RawAlias[];
194
+ attributes?: {
195
+ type?: string;
196
+ value?: string;
197
+ 'type-id'?: string;
198
+ }[];
199
+ disambiguation?: string;
200
+ genres?: RawTag[];
201
+ id: string;
202
+ iswcs?: string[];
203
+ language?: string | null;
204
+ languages?: string[];
205
+ relations?: RawRelation[];
206
+ score?: number;
207
+ tags?: RawTag[];
208
+ title?: string;
209
+ type?: string | null;
210
+ 'type-id'?: string | null;
211
+ }
212
+ export interface RawLabel {
213
+ aliases?: RawAlias[];
214
+ area?: RawArea | null;
215
+ country?: string | null;
216
+ disambiguation?: string;
217
+ genres?: RawTag[];
218
+ id: string;
219
+ 'label-code'?: number | null;
220
+ 'life-span'?: RawLifeSpan;
221
+ name?: string;
222
+ relations?: RawRelation[];
223
+ score?: number;
224
+ 'sort-name'?: string;
225
+ tags?: RawTag[];
226
+ type?: string | null;
227
+ 'type-id'?: string | null;
228
+ }
229
+ /**
230
+ * Search response envelope. The entity array is keyed by the pluralized type
231
+ * (`artists`, `release-groups`, `releases`, `recordings`, `works`, `labels`).
232
+ * `count` is total matches; per-result `score` is 0–100 Lucene relevance.
233
+ */
234
+ export interface SearchEnvelope {
235
+ artists?: RawArtist[];
236
+ count?: number;
237
+ created?: string;
238
+ labels?: RawLabel[];
239
+ offset?: number;
240
+ recordings?: RawRecording[];
241
+ 'release-groups'?: RawReleaseGroup[];
242
+ releases?: RawRelease[];
243
+ works?: RawWork[];
244
+ }
245
+ /**
246
+ * Browse response envelope — distinct from search: the total lives under
247
+ * `{type}-count` (e.g. `release-count`), not `count`. `offset` pages arbitrarily
248
+ * deep. Identifier endpoints (`/iswc`) share this browse-style shape.
249
+ */
250
+ export interface BrowseEnvelope {
251
+ 'artist-count'?: number;
252
+ 'artist-offset'?: number;
253
+ artists?: RawArtist[];
254
+ 'label-count'?: number;
255
+ 'label-offset'?: number;
256
+ labels?: RawLabel[];
257
+ 'recording-count'?: number;
258
+ 'recording-offset'?: number;
259
+ recordings?: RawRecording[];
260
+ 'release-count'?: number;
261
+ 'release-group-count'?: number;
262
+ 'release-group-offset'?: number;
263
+ 'release-groups'?: RawReleaseGroup[];
264
+ 'release-offset'?: number;
265
+ releases?: RawRelease[];
266
+ 'work-count'?: number;
267
+ 'work-offset'?: number;
268
+ works?: RawWork[];
269
+ }
270
+ /** ISRC endpoint response: `{ isrc, recordings[] }` (one ISRC → many recordings). */
271
+ export interface IsrcEnvelope {
272
+ isrc?: string;
273
+ recordings?: RawRecording[];
274
+ }
275
+ /** Cover Art Archive response shape (identical before and after the release-group 307 redirect). */
276
+ export interface RawCoverArtResponse {
277
+ images?: RawCoverArtImage[];
278
+ release?: string;
279
+ }
280
+ export interface RawCoverArtImage {
281
+ approved?: boolean;
282
+ back?: boolean;
283
+ comment?: string;
284
+ edit?: number;
285
+ front?: boolean;
286
+ id?: string | number;
287
+ image?: string;
288
+ thumbnails?: {
289
+ '250'?: string;
290
+ '500'?: string;
291
+ '1200'?: string;
292
+ small?: string;
293
+ large?: string;
294
+ };
295
+ types?: string[];
296
+ }
297
+ /** Options threaded through service calls for cancellation. */
298
+ export interface CallOptions {
299
+ signal?: AbortSignal;
300
+ }
301
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * @fileoverview Domain types for the MusicBrainz Web Service v2. Raw types model
3
+ * the upstream JSON shapes as they actually arrive — sparse and optional-heavy,
4
+ * since MusicBrainz omits fields entirely (and a field can present differently
5
+ * between search and lookup, e.g. `life-span.ended` is `null` from search but
6
+ * `false` from lookup). Normalization preserves absence as "unknown" rather than
7
+ * fabricating concrete values.
8
+ * @module services/musicbrainz/types
9
+ */
10
+ export {};
11
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
package/package.json ADDED
@@ -0,0 +1,103 @@
1
+ {
2
+ "name": "@cyanheads/musicbrainz-mcp-server",
3
+ "version": "0.1.0",
4
+ "mcpName": "io.github.cyanheads/musicbrainz-mcp-server",
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
+ "type": "module",
7
+ "main": "dist/index.js",
8
+ "types": "dist/index.d.ts",
9
+ "bin": {
10
+ "musicbrainz-mcp-server": "dist/index.js"
11
+ },
12
+ "files": [
13
+ "changelog/",
14
+ "dist/",
15
+ "README.md",
16
+ "LICENSE",
17
+ "CLAUDE.md",
18
+ "AGENTS.md",
19
+ "Dockerfile",
20
+ "server.json"
21
+ ],
22
+ "scripts": {
23
+ "build": "bun run scripts/build.ts",
24
+ "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
25
+ "clean": "bun run scripts/clean.ts",
26
+ "devcheck": "bun run scripts/devcheck.ts",
27
+ "audit:refresh": "rm -f bun.lock && bun install && bun audit",
28
+ "tree": "bun run scripts/tree.ts",
29
+ "list-skills": "bun run scripts/list-skills.ts",
30
+ "format": "biome check --write .",
31
+ "format:unsafe": "biome check --write --unsafe .",
32
+ "lint:mcp": "bun run scripts/lint-mcp.ts",
33
+ "lint:packaging": "bun run scripts/lint-packaging.ts",
34
+ "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb",
35
+ "changelog:build": "bun run scripts/build-changelog.ts",
36
+ "changelog:check": "bun run scripts/build-changelog.ts --check",
37
+ "release:github": "bun run scripts/release-github.ts",
38
+ "test": "vitest run",
39
+ "start": "node dist/index.js",
40
+ "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
41
+ "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
42
+ },
43
+ "keywords": [
44
+ "musicbrainz",
45
+ "cover-art-archive",
46
+ "music-metadata",
47
+ "discography",
48
+ "mbid",
49
+ "isrc",
50
+ "iswc",
51
+ "music",
52
+ "mcp",
53
+ "mcp-server",
54
+ "model-context-protocol",
55
+ "typescript",
56
+ "bun",
57
+ "stdio",
58
+ "streamable-http",
59
+ "ai-agent"
60
+ ],
61
+ "repository": {
62
+ "type": "git",
63
+ "url": "git+https://github.com/cyanheads/musicbrainz-mcp-server.git"
64
+ },
65
+ "bugs": {
66
+ "url": "https://github.com/cyanheads/musicbrainz-mcp-server/issues"
67
+ },
68
+ "homepage": "https://github.com/cyanheads/musicbrainz-mcp-server#readme",
69
+ "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/musicbrainz-mcp-server#readme)",
70
+ "funding": [
71
+ {
72
+ "type": "github",
73
+ "url": "https://github.com/sponsors/cyanheads"
74
+ },
75
+ {
76
+ "type": "buy_me_a_coffee",
77
+ "url": "https://www.buymeacoffee.com/cyanheads"
78
+ }
79
+ ],
80
+ "license": "Apache-2.0",
81
+ "packageManager": "bun@1.3.2",
82
+ "engines": {
83
+ "bun": ">=1.3.0",
84
+ "node": ">=24.0.0"
85
+ },
86
+ "publishConfig": {
87
+ "access": "public"
88
+ },
89
+ "dependencies": {
90
+ "@cyanheads/mcp-ts-core": "^0.10.6",
91
+ "pino-pretty": "^13.1.3",
92
+ "zod": "^4.4.3"
93
+ },
94
+ "devDependencies": {
95
+ "@biomejs/biome": "2.5.0",
96
+ "@types/node": "25.9.3",
97
+ "depcheck": "^1.4.7",
98
+ "ignore": "^7.0.5",
99
+ "tsc-alias": "^1.8.17",
100
+ "typescript": "^6.0.3",
101
+ "vitest": "^4.1.8"
102
+ }
103
+ }
package/server.json ADDED
@@ -0,0 +1,111 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.cyanheads/musicbrainz-mcp-server",
4
+ "description": "Search MusicBrainz artists, releases, works, labels; resolve ISRC/ISWC/barcode; fetch cover art.",
5
+ "repository": {
6
+ "url": "https://github.com/cyanheads/musicbrainz-mcp-server",
7
+ "source": "github"
8
+ },
9
+ "version": "0.1.0",
10
+ "packages": [
11
+ {
12
+ "registryType": "npm",
13
+ "registryBaseUrl": "https://registry.npmjs.org",
14
+ "identifier": "@cyanheads/musicbrainz-mcp-server",
15
+ "runtimeHint": "bun",
16
+ "version": "0.1.0",
17
+ "packageArguments": [
18
+ {
19
+ "type": "positional",
20
+ "value": "run"
21
+ },
22
+ {
23
+ "type": "positional",
24
+ "value": "start:stdio"
25
+ }
26
+ ],
27
+ "environmentVariables": [
28
+ {
29
+ "name": "MUSICBRAINZ_CONTACT",
30
+ "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.",
31
+ "format": "string",
32
+ "isRequired": false
33
+ },
34
+ {
35
+ "name": "MCP_LOG_LEVEL",
36
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
37
+ "format": "string",
38
+ "isRequired": false,
39
+ "default": "info"
40
+ }
41
+ ],
42
+ "transport": {
43
+ "type": "stdio"
44
+ }
45
+ },
46
+ {
47
+ "registryType": "npm",
48
+ "registryBaseUrl": "https://registry.npmjs.org",
49
+ "identifier": "@cyanheads/musicbrainz-mcp-server",
50
+ "runtimeHint": "bun",
51
+ "version": "0.1.0",
52
+ "packageArguments": [
53
+ {
54
+ "type": "positional",
55
+ "value": "run"
56
+ },
57
+ {
58
+ "type": "positional",
59
+ "value": "start:http"
60
+ }
61
+ ],
62
+ "environmentVariables": [
63
+ {
64
+ "name": "MUSICBRAINZ_CONTACT",
65
+ "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.",
66
+ "format": "string",
67
+ "isRequired": false
68
+ },
69
+ {
70
+ "name": "MCP_HTTP_HOST",
71
+ "description": "The hostname for the HTTP server.",
72
+ "format": "string",
73
+ "isRequired": false,
74
+ "default": "127.0.0.1"
75
+ },
76
+ {
77
+ "name": "MCP_HTTP_PORT",
78
+ "description": "The port to run the HTTP server on.",
79
+ "format": "string",
80
+ "isRequired": false,
81
+ "default": "3010"
82
+ },
83
+ {
84
+ "name": "MCP_HTTP_ENDPOINT_PATH",
85
+ "description": "The endpoint path for the MCP server.",
86
+ "format": "string",
87
+ "isRequired": false,
88
+ "default": "/mcp"
89
+ },
90
+ {
91
+ "name": "MCP_AUTH_MODE",
92
+ "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
93
+ "format": "string",
94
+ "isRequired": false,
95
+ "default": "none"
96
+ },
97
+ {
98
+ "name": "MCP_LOG_LEVEL",
99
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
100
+ "format": "string",
101
+ "isRequired": false,
102
+ "default": "info"
103
+ }
104
+ ],
105
+ "transport": {
106
+ "type": "streamable-http",
107
+ "url": "http://localhost:3010/mcp"
108
+ }
109
+ }
110
+ ]
111
+ }