@cyanheads/musicbrainz-mcp-server 0.1.0 → 0.1.2
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 +1 -1
- package/CLAUDE.md +1 -1
- package/README.md +33 -2
- package/changelog/0.1.x/0.1.1.md +11 -0
- package/changelog/0.1.x/0.1.2.md +16 -0
- package/package.json +3 -2
- package/server.json +9 -3
package/AGENTS.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Developer Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** musicbrainz-mcp-server
|
|
4
|
-
**Version:** 0.1.
|
|
4
|
+
**Version:** 0.1.2
|
|
5
5
|
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.6`
|
|
6
6
|
**Engines:** Bun ≥1.3.0, Node ≥24.0.0
|
|
7
7
|
**MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
|
package/CLAUDE.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Developer Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** musicbrainz-mcp-server
|
|
4
|
-
**Version:** 0.1.
|
|
4
|
+
**Version:** 0.1.2
|
|
5
5
|
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.6`
|
|
6
6
|
**Engines:** Bun ≥1.3.0, Node ≥24.0.0
|
|
7
7
|
**MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
|
package/README.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<div align="center">
|
|
2
|
-
<h1
|
|
2
|
+
<h1>@cyanheads/musicbrainz-mcp-server</h1>
|
|
3
3
|
<p><b>Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.</b>
|
|
4
4
|
<div>10 Tools • 1 Resource</div>
|
|
5
5
|
</p>
|
|
@@ -7,12 +7,28 @@
|
|
|
7
7
|
|
|
8
8
|
<div align="center">
|
|
9
9
|
|
|
10
|
-
[](./CHANGELOG.md) [](./LICENSE) [](https://modelcontextprotocol.io/) [](https://www.typescriptlang.org/) [](https://bun.sh/)
|
|
11
|
+
|
|
12
|
+
</div>
|
|
13
|
+
|
|
14
|
+
<div align="center">
|
|
15
|
+
|
|
16
|
+
[](https://github.com/cyanheads/musicbrainz-mcp-server/releases/latest/download/musicbrainz-mcp-server.mcpb) [](https://cursor.com/en/install-mcp?name=musicbrainz-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvbXVzaWNicmFpbnotbWNwLXNlcnZlciJdfQ==) [](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22musicbrainz-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads/musicbrainz-mcp-server%22%5D%7D)
|
|
17
|
+
|
|
18
|
+
</div>
|
|
19
|
+
|
|
20
|
+
<div align="center">
|
|
11
21
|
|
|
12
22
|
[](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
|
|
13
23
|
|
|
14
24
|
</div>
|
|
15
25
|
|
|
26
|
+
<div align="center">
|
|
27
|
+
|
|
28
|
+
**Public Hosted Server:** [https://musicbrainz.caseyjhand.com/mcp](https://musicbrainz.caseyjhand.com/mcp)
|
|
29
|
+
|
|
30
|
+
</div>
|
|
31
|
+
|
|
16
32
|
---
|
|
17
33
|
|
|
18
34
|
## Tools
|
|
@@ -135,6 +151,21 @@ Agent-friendly output:
|
|
|
135
151
|
|
|
136
152
|
`musicbrainz-mcp-server` is keyless — no API key or account. MusicBrainz does require a descriptive `User-Agent` with a contact and rate-limits to ~1 request/second per IP; the server ships a default contact so it works out of the box, but operators running a shared or hosted instance should set `MUSICBRAINZ_CONTACT` to their own email or URL.
|
|
137
153
|
|
|
154
|
+
### Public Hosted Instance
|
|
155
|
+
|
|
156
|
+
A public instance is available at `https://musicbrainz.caseyjhand.com/mcp` — no installation required. Point any MCP client at it via Streamable HTTP, with this client config:
|
|
157
|
+
|
|
158
|
+
```json
|
|
159
|
+
{
|
|
160
|
+
"mcpServers": {
|
|
161
|
+
"musicbrainz-mcp-server": {
|
|
162
|
+
"type": "streamable-http",
|
|
163
|
+
"url": "https://musicbrainz.caseyjhand.com/mcp"
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
```
|
|
168
|
+
|
|
138
169
|
Add the following to your MCP client configuration file.
|
|
139
170
|
|
|
140
171
|
```json
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "Scope the README title to the published package name @cyanheads/musicbrainz-mcp-server."
|
|
3
|
+
breaking: false
|
|
4
|
+
security: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 0.1.1 — 2026-06-14
|
|
8
|
+
|
|
9
|
+
## Changed
|
|
10
|
+
|
|
11
|
+
- **README** — the `<h1>` now reads `@cyanheads/musicbrainz-mcp-server`, matching the published npm package name.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "Public hosted endpoint at https://musicbrainz.caseyjhand.com/mcp; install badges (Claude Desktop, Cursor, VS Code)."
|
|
3
|
+
breaking: false
|
|
4
|
+
security: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 0.1.2 — 2026-06-15
|
|
8
|
+
|
|
9
|
+
## Added
|
|
10
|
+
|
|
11
|
+
- **Hosted endpoint** — public instance at `https://musicbrainz.caseyjhand.com/mcp` (Streamable HTTP, no installation required). Added to `server.json` `remotes[]` and documented in README header and Getting Started.
|
|
12
|
+
- **Install badges** — Claude Desktop (`.mcpb`), Cursor, and VS Code one-click install links added to the README header.
|
|
13
|
+
|
|
14
|
+
## Changed
|
|
15
|
+
|
|
16
|
+
- `vitest` ^4.1.8 → ^4.1.9
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cyanheads/musicbrainz-mcp-server",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
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",
|
|
@@ -35,6 +35,7 @@
|
|
|
35
35
|
"changelog:build": "bun run scripts/build-changelog.ts",
|
|
36
36
|
"changelog:check": "bun run scripts/build-changelog.ts --check",
|
|
37
37
|
"release:github": "bun run scripts/release-github.ts",
|
|
38
|
+
"publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
|
|
38
39
|
"test": "vitest run",
|
|
39
40
|
"start": "node dist/index.js",
|
|
40
41
|
"start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
|
|
@@ -98,6 +99,6 @@
|
|
|
98
99
|
"ignore": "^7.0.5",
|
|
99
100
|
"tsc-alias": "^1.8.17",
|
|
100
101
|
"typescript": "^6.0.3",
|
|
101
|
-
"vitest": "^4.1.
|
|
102
|
+
"vitest": "^4.1.9"
|
|
102
103
|
}
|
|
103
104
|
}
|
package/server.json
CHANGED
|
@@ -6,14 +6,20 @@
|
|
|
6
6
|
"url": "https://github.com/cyanheads/musicbrainz-mcp-server",
|
|
7
7
|
"source": "github"
|
|
8
8
|
},
|
|
9
|
-
"version": "0.1.
|
|
9
|
+
"version": "0.1.2",
|
|
10
|
+
"remotes": [
|
|
11
|
+
{
|
|
12
|
+
"type": "streamable-http",
|
|
13
|
+
"url": "https://musicbrainz.caseyjhand.com/mcp"
|
|
14
|
+
}
|
|
15
|
+
],
|
|
10
16
|
"packages": [
|
|
11
17
|
{
|
|
12
18
|
"registryType": "npm",
|
|
13
19
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
14
20
|
"identifier": "@cyanheads/musicbrainz-mcp-server",
|
|
15
21
|
"runtimeHint": "bun",
|
|
16
|
-
"version": "0.1.
|
|
22
|
+
"version": "0.1.2",
|
|
17
23
|
"packageArguments": [
|
|
18
24
|
{
|
|
19
25
|
"type": "positional",
|
|
@@ -48,7 +54,7 @@
|
|
|
48
54
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
49
55
|
"identifier": "@cyanheads/musicbrainz-mcp-server",
|
|
50
56
|
"runtimeHint": "bun",
|
|
51
|
-
"version": "0.1.
|
|
57
|
+
"version": "0.1.2",
|
|
52
58
|
"packageArguments": [
|
|
53
59
|
{
|
|
54
60
|
"type": "positional",
|