sonovault-mcp 1.0.2 → 1.0.4
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 +7 -3
- package/dist/index.js +4 -4
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
[](https://github.com/rekordcloud/sonovault-mcp/actions/workflows/ci.yml)
|
|
4
4
|
[](https://www.npmjs.com/package/sonovault-mcp)
|
|
5
5
|
|
|
6
|
-
MCP server for the **[SonoVault](https://sonovault.now)** music metadata API. Gives Claude, Cursor, and any MCP client search across
|
|
6
|
+
MCP server for the **[SonoVault](https://sonovault.now)** music metadata API. Gives Claude, Cursor, and any MCP client search across 93M+ tracks, artists, labels, and releases, with full metadata per result: genre, label, release dates, artist credits, ISRC and ISWC codes, and cross-platform IDs (Spotify, Apple Music, Tidal, Beatport, Discogs, MusicBrainz, YouTube).
|
|
7
7
|
|
|
8
8
|
Ask your assistant things like:
|
|
9
9
|
|
|
@@ -91,9 +91,9 @@ Any client that speaks MCP over stdio works. Command: `npx -y sonovault-mcp` wit
|
|
|
91
91
|
| `get_recordings_of_work` | Composition to recordings: every recording of an ISWC. |
|
|
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
|
-
| `search_artists`, `get_artist_releases` | Artist search and discography. |
|
|
94
|
+
| `search_artists`, `get_artist_releases` | Artist search and discography, with Wikidata and MusicBrainz identifiers. |
|
|
95
95
|
| `search_labels`, `get_label_releases` | Label search and catalog. |
|
|
96
|
-
| `search_releases`, `get_release` | Release search and tracklists with ISRCs. |
|
|
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. |
|
|
97
97
|
| `list_genres` | The canonical genre hierarchy. |
|
|
98
98
|
| `browse_tracks` | Discover by label, artist, genre, or year (paid tier). |
|
|
99
99
|
|
|
@@ -147,6 +147,10 @@ Single-platform APIs return their own IDs only. SonoVault resolves one recording
|
|
|
147
147
|
|
|
148
148
|
No. The server runs locally over stdio and sends your key only to `api.sonovault.now` as a request header. The code is small and auditable: [src/server.ts](src/server.ts).
|
|
149
149
|
|
|
150
|
+
## Agent Skill
|
|
151
|
+
|
|
152
|
+
Not using MCP? [`skill/SKILL.md`](skill/SKILL.md) is an [Agent Skill](https://agentskills.io/) that teaches any agent to call the SonoVault API directly over HTTP: search rules, ISRC/ISWC recipes, bulk resolution, and error handling.
|
|
153
|
+
|
|
150
154
|
## Related
|
|
151
155
|
|
|
152
156
|
- [SonoVault API docs](https://sonovault.now/docs)
|
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.0.
|
|
11
|
+
var SERVER_VERSION = "1.0.4";
|
|
12
12
|
function json(data) {
|
|
13
13
|
return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
|
|
14
14
|
}
|
|
@@ -31,7 +31,7 @@ function createServer(sv2) {
|
|
|
31
31
|
"search_tracks",
|
|
32
32
|
{
|
|
33
33
|
title: "Search tracks",
|
|
34
|
-
description: "Search the SonoVault catalog (
|
|
34
|
+
description: "Search the SonoVault catalog (93M+ tracks) by artist and title. Both are required; there is no free-text search. Returns ISRC, genre, duration, artist credits, and release info (album, label, release date) per track.",
|
|
35
35
|
inputSchema: {
|
|
36
36
|
artist: z.string().describe("Artist name, e.g. 'Daft Punk'"),
|
|
37
37
|
title: z.string().describe("Track title, e.g. 'One More Time'"),
|
|
@@ -127,7 +127,7 @@ function createServer(sv2) {
|
|
|
127
127
|
"search_artists",
|
|
128
128
|
{
|
|
129
129
|
title: "Search artists",
|
|
130
|
-
description: "Search artists by name. Returns id, name, country, formation year, and
|
|
130
|
+
description: "Search artists by name. Returns id, name, country, formation year, release count, and the wikidata_id and musicbrainz_id identifiers for joining against external datasets.",
|
|
131
131
|
inputSchema: {
|
|
132
132
|
name: z.string().describe("Artist name to search for"),
|
|
133
133
|
limit: z.number().int().min(1).max(100).optional()
|
|
@@ -190,7 +190,7 @@ function createServer(sv2) {
|
|
|
190
190
|
"get_release",
|
|
191
191
|
{
|
|
192
192
|
title: "Get release with tracklist",
|
|
193
|
-
description: "Fetch one release by SonoVault release ID, including its full tracklist with ISRCs.",
|
|
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. Also returns musicbrainz_release_ids and musicbrainz_release_group_ids: arrays, because a SonoVault release groups every edition of an album and each edition has its own MBID.",
|
|
194
194
|
inputSchema: { id: z.number().int().describe("SonoVault release ID") }
|
|
195
195
|
},
|
|
196
196
|
wrap(async ({ id }) => sv2.releases.get(id))
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sonovault-mcp",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "MCP server for the SonoVault music metadata API. Search
|
|
3
|
+
"version": "1.0.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": [
|
|
7
7
|
"mcp",
|
|
@@ -43,7 +43,7 @@
|
|
|
43
43
|
},
|
|
44
44
|
"dependencies": {
|
|
45
45
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
46
|
-
"sonovault": "^
|
|
46
|
+
"sonovault": "^3.0.0",
|
|
47
47
|
"zod": "^3.25.0"
|
|
48
48
|
},
|
|
49
49
|
"devDependencies": {
|