@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 CHANGED
@@ -1,7 +1,7 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** musicbrainz-mcp-server
4
- **Version:** 0.1.0
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.0
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>musicbrainz-mcp-server</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
- [![Version](https://img.shields.io/badge/Version-0.1.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
10
+ [![Version](https://img.shields.io/badge/Version-0.1.2-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
11
+
12
+ </div>
13
+
14
+ <div align="center">
15
+
16
+ [![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/musicbrainz-mcp-server/releases/latest/download/musicbrainz-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=musicbrainz-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvbXVzaWNicmFpbnotbWNwLXNlcnZlciJdfQ==) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](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
  [![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](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.0",
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.8"
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.0",
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.0",
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.0",
57
+ "version": "0.1.2",
52
58
  "packageArguments": [
53
59
  {
54
60
  "type": "positional",