sonovault-mcp 1.1.0 → 1.2.1
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/README.md +2 -2
- package/dist/index.js +15 -10
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -92,8 +92,8 @@ Any client that speaks MCP over stdio works. Command: `npx -y sonovault-mcp` wit
|
|
|
92
92
|
| `get_platform_links` | One track's ID and deep link on all 7 platforms, from any ID or ISRC. |
|
|
93
93
|
| `resolve_tracks` | Bulk resolve up to 100 track names, ISRCs, or platform IDs. |
|
|
94
94
|
| `search_artists`, `get_artist_releases` | Artist search and discography, with Wikidata and MusicBrainz identifiers. |
|
|
95
|
-
| `search_labels`, `get_label_releases` | Label search and catalog. |
|
|
96
|
-
| `search_releases`, `get_release` | Release search, and tracklists with ISRCs in playing order with disc and track numbers, plus MusicBrainz release and release-group ids. `get_release` also lists the real editions behind a release and takes an `edition` id to render that edition's numbering. |
|
|
95
|
+
| `search_labels`, `get_label_releases` | Label search and catalog, optionally for one release date or a date range. |
|
|
96
|
+
| `search_releases`, `get_release` | Release search, and tracklists with ISRCs in playing order with disc and track numbers, plus MusicBrainz release and release-group ids. `get_release` also lists the real editions behind a release, each with its own label and catalog number, and takes an `edition` id to render that edition's numbering. |
|
|
97
97
|
| `list_genres` | The canonical genre hierarchy. |
|
|
98
98
|
| `browse_tracks` | Discover by label, artist, genre, or year (paid tier). |
|
|
99
99
|
|
package/dist/index.js
CHANGED
|
@@ -8,7 +8,7 @@ import { SonoVault as SonoVault2 } from "sonovault";
|
|
|
8
8
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
9
9
|
import { SonoVaultError } from "sonovault";
|
|
10
10
|
import { z } from "zod";
|
|
11
|
-
var SERVER_VERSION = "1.1
|
|
11
|
+
var SERVER_VERSION = "1.2.1";
|
|
12
12
|
function json(data) {
|
|
13
13
|
return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
|
|
14
14
|
}
|
|
@@ -16,6 +16,7 @@ function toolError(err) {
|
|
|
16
16
|
const message = err instanceof SonoVaultError ? `SonoVault API error (HTTP ${err.status}): ${err.message}` + (err.isForbidden ? " (this endpoint needs a paid SonoVault tier)" : "") + (err.isAuthError ? " (check SONOVAULT_API_KEY)" : "") : `Error: ${err.message}`;
|
|
17
17
|
return { content: [{ type: "text", text: message }], isError: true };
|
|
18
18
|
}
|
|
19
|
+
var DATE = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Expected YYYY-MM-DD");
|
|
19
20
|
function wrap(fn) {
|
|
20
21
|
return async (...args) => {
|
|
21
22
|
try {
|
|
@@ -94,7 +95,7 @@ function createServer(sv2) {
|
|
|
94
95
|
applemusic_id: z.string().optional(),
|
|
95
96
|
tidal_id: z.string().optional(),
|
|
96
97
|
beatport_id: z.string().optional(),
|
|
97
|
-
discogs_id: z.string().optional(),
|
|
98
|
+
discogs_id: z.string().optional().describe("Discogs track key: release ID plus track position, e.g. '2844-A'. A bare release ID matches nothing."),
|
|
98
99
|
musicbrainz_id: z.string().optional(),
|
|
99
100
|
youtube_id: z.string().optional()
|
|
100
101
|
}
|
|
@@ -105,7 +106,7 @@ function createServer(sv2) {
|
|
|
105
106
|
"resolve_tracks",
|
|
106
107
|
{
|
|
107
108
|
title: "Bulk resolve",
|
|
108
|
-
description: "Resolve up to 100 inputs in one call to canonical tracks plus cross-platform links. input_type picks the key: 'track_name' (items are {artist, title} objects), 'isrc', 'sonovault_id', or a platform id type ('spotify_id', 'applemusic_id', 'tidal_id', 'beatport_id', 'discogs_id', 'musicbrainz_id'). Costs one API credit per line.",
|
|
109
|
+
description: "Resolve up to 100 inputs in one call to canonical tracks plus cross-platform links. input_type picks the key: 'track_name' (items are {artist, title} objects), 'isrc', 'sonovault_id', or a platform id type ('spotify_id', 'applemusic_id', 'tidal_id', 'beatport_id', 'discogs_id', 'musicbrainz_id'). A discogs_id item is a Discogs track key (release ID plus track position, e.g. '2844-A'), not a bare release ID. Costs one API credit per line.",
|
|
109
110
|
inputSchema: {
|
|
110
111
|
input_type: z.enum([
|
|
111
112
|
"track_name",
|
|
@@ -139,14 +140,16 @@ function createServer(sv2) {
|
|
|
139
140
|
"get_artist_releases",
|
|
140
141
|
{
|
|
141
142
|
title: "Artist releases",
|
|
142
|
-
description: "An artist's releases, newest first. Use the cursor from a previous call for the next page.",
|
|
143
|
+
description: "An artist's releases, newest first. Use the cursor from a previous call for the next page. Optional from/until (YYYY-MM-DD, inclusive) limit it to a release-date range.",
|
|
143
144
|
inputSchema: {
|
|
144
145
|
artist_id: z.number().int().describe("SonoVault artist ID (from search_artists)"),
|
|
145
146
|
limit: z.number().int().min(1).max(100).optional(),
|
|
146
|
-
cursor: z.string().optional().describe("next_cursor from the previous page")
|
|
147
|
+
cursor: z.string().optional().describe("next_cursor from the previous page"),
|
|
148
|
+
from: DATE.optional().describe("Only releases dated on or after this day (YYYY-MM-DD)"),
|
|
149
|
+
until: DATE.optional().describe("Only releases dated on or before this day (YYYY-MM-DD)")
|
|
147
150
|
}
|
|
148
151
|
},
|
|
149
|
-
wrap(async ({ artist_id, limit, cursor }) => sv2.artists.releases(artist_id, { limit, cursor }))
|
|
152
|
+
wrap(async ({ artist_id, limit, cursor, from, until }) => sv2.artists.releases(artist_id, { limit, cursor, from, until }))
|
|
150
153
|
);
|
|
151
154
|
server2.registerTool(
|
|
152
155
|
"search_labels",
|
|
@@ -164,14 +167,16 @@ function createServer(sv2) {
|
|
|
164
167
|
"get_label_releases",
|
|
165
168
|
{
|
|
166
169
|
title: "Label releases",
|
|
167
|
-
description: "A label's releases, newest first, with artist per release. Cursor-paginated.",
|
|
170
|
+
description: "A label's releases, newest first, with artist per release. Cursor-paginated. Optional from/until (YYYY-MM-DD, inclusive) limit it to a release-date range; pass the same day for both to see what the label released that day.",
|
|
168
171
|
inputSchema: {
|
|
169
172
|
label_id: z.number().int().describe("SonoVault label ID (from search_labels)"),
|
|
170
173
|
limit: z.number().int().min(1).max(100).optional(),
|
|
171
|
-
cursor: z.string().optional()
|
|
174
|
+
cursor: z.string().optional(),
|
|
175
|
+
from: DATE.optional().describe("Only releases dated on or after this day (YYYY-MM-DD)"),
|
|
176
|
+
until: DATE.optional().describe("Only releases dated on or before this day (YYYY-MM-DD)")
|
|
172
177
|
}
|
|
173
178
|
},
|
|
174
|
-
wrap(async ({ label_id, limit, cursor }) => sv2.labels.releases(label_id, { limit, cursor }))
|
|
179
|
+
wrap(async ({ label_id, limit, cursor, from, until }) => sv2.labels.releases(label_id, { limit, cursor, from, until }))
|
|
175
180
|
);
|
|
176
181
|
server2.registerTool(
|
|
177
182
|
"search_releases",
|
|
@@ -190,7 +195,7 @@ function createServer(sv2) {
|
|
|
190
195
|
"get_release",
|
|
191
196
|
{
|
|
192
197
|
title: "Get release with tracklist",
|
|
193
|
-
description: "Fetch one release by SonoVault release ID, including its full tracklist with ISRCs. Tracks come back in playing order, each with disc_number and track_number; a track whose position is unknown sorts last with both null. A SonoVault release groups every edition of an album onto one record, so the response also carries an editions array naming the real editions behind it, each with its provider, format, release date, barcode, country and
|
|
198
|
+
description: "Fetch one release by SonoVault release ID, including its full tracklist with ISRCs. Tracks come back in playing order, each with disc_number and track_number; a track whose position is unknown sorts last with both null. A SonoVault release groups every edition of an album onto one record, so the response also carries an editions array naming the real editions behind it, each with its provider, format, release date, barcode, country, track count, label and catalog number (pressings of one album often carry different labels); pass one of their ids as `edition` to render that edition's numbering instead of the default consensus. musicbrainz_release_ids and musicbrainz_release_group_ids are arrays for the same reason.",
|
|
194
199
|
inputSchema: {
|
|
195
200
|
id: z.number().int().describe("SonoVault release ID"),
|
|
196
201
|
edition: z.number().int().optional().describe("Edition id from the response's editions array. Renders that edition's track numbering; tracks it does not carry keep a null position and come last.")
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sonovault-mcp",
|
|
3
|
-
"version": "1.1
|
|
3
|
+
"version": "1.2.1",
|
|
4
4
|
"description": "MCP server for the SonoVault music metadata API. Search 93M+ tracks, artists, and releases; get genre, label, release dates, ISRC/ISWC codes, and cross-platform IDs.",
|
|
5
5
|
"mcpName": "io.github.rekordcloud/sonovault",
|
|
6
6
|
"keywords": [
|
|
@@ -43,7 +43,7 @@
|
|
|
43
43
|
},
|
|
44
44
|
"dependencies": {
|
|
45
45
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
46
|
-
"sonovault": "^4.
|
|
46
|
+
"sonovault": "^4.2.0",
|
|
47
47
|
"zod": "^3.25.0"
|
|
48
48
|
},
|
|
49
49
|
"devDependencies": {
|