sonovault

sonovault-mcp

SonoVault の音楽メタデータ API 用 MCP サーバーです。Claude、Cursor、およびあらゆる MCP クライアントから、9,300 万件以上のトラック、アーティスト、レーベル、リリースを検索できます。各検索結果には、ジャンル、BPM、調、レーベル、リリース日、アーティストクレジット、ISRC および ISWC コード、各プラットフォームの ID（Spotify、Apple Music、Tidal、Beatport、Discogs、MusicBrainz、YouTube）などの完全なメタデータが含まれます。

アシスタントに次のような質問をできます。

• 「今年、mau5trap からリリースされた作品は？」
• 「Daft Punk の Veridis Quo を探して、ジャンル、レーベル、ISRC を教えて」
• 「One More Time の調と BPM は？Discovery の中で、この曲とミックスしやすいトラックはどれ？」
• 「Discovery のトラックリストを ISRC 付きで見せて」
• 「ISRC GBDUW0000053 の Spotify ID と Beatport ID は？」
• 「この再生ログを ISRC とレーベルに変換して」（最大 100 行を貼り付け）
• 「ISWC T-071.020.439-9 の録音をすべて一覧表示して」

セットアップ

SonoVault API キーが必要です。無料プランではクレジットカード不要で、月 1,000 回までリクエストできます。キーを取得

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "sonovault": {
      "command": "npx",
      "args": ["-y", "sonovault-mcp"],
      "env": { "SONOVAULT_API_KEY": "svk_live_..." }
    }
  }
}

Claude Code

claude mcp add sonovault -e SONOVAULT_API_KEY=svk_live_... -- npx -y sonovault-mcp

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "sonovault": {
      "command": "npx",
      "args": ["-y", "sonovault-mcp"],
      "env": { "SONOVAULT_API_KEY": "svk_live_..." }
    }
  }
}

VS Code（GitHub Copilot）

.vscode/mcp.json に追加します。

{
  "servers": {
    "sonovault": {
      "command": "npx",
      "args": ["-y", "sonovault-mcp"],
      "env": { "SONOVAULT_API_KEY": "svk_live_..." }
    }
  }
}

Windsurf

Claude Desktop と同じ mcpServers ブロックを ~/.codeium/windsurf/mcp_config.json に追加します。

その他の MCP クライアント

stdio 経由で MCP を利用するクライアントであれば動作します。コマンドは npx -y sonovault-mcp です。SONOVAULT_API_KEY 環境変数を設定してください。

ツール

ツール	機能
search_tracks	アーティスト名と曲名であいまい検索します。ISRC、ジャンル、BPM、調、レーベル、リリース日を返します。
lookup_isrc	ISRC で録音を完全一致検索し、BPM と調も返します。
get_track	SonoVault ID でトラックを取得し、BPM と調も返します。
get_work_codes	録音から楽曲を検索します。録音に対応する ISWC を返します。
get_recordings_of_work	楽曲から録音を検索します。ISWC に対応する録音をすべて返します。
get_platform_links	任意の ID または ISRC から、1 曲について 7 つのプラットフォームすべての ID とディープリンクを取得します。
resolve_tracks	最大 100 件の曲名、ISRC、またはプラットフォーム ID を一括で解決します。
search_artists, get_artist_releases	アーティストを検索し、ディスコグラフィーを取得します。Wikidata と MusicBrainz の識別子も含まれます。
search_labels, get_label_releases	レーベルを検索し、カタログを取得します。特定の日付または日付範囲を指定することもできます。
search_releases, get_release	リリースを検索し、演奏順、ディスク番号、トラック番号付きのトラックリストを取得します。ISRC、BPM、調、MusicBrainz のリリース ID およびリリースグループ ID も含まれます。get_release は、リリースの実際の各エディションも一覧表示します。各エディションには独自のレーベルとカタログ番号があり、edition ID を指定すると、そのエディションの番号付けで表示できます。
list_genres	正式なジャンル階層を表示します。
browse_tracks	レーベル、アーティスト、ジャンル、または年で検索します（有料プラン）。

すべてのツールは読み取り専用です。ほとんどのツールは無料プランで利用できますが、browse_tracks には有料プランが必要です。

ワークフローの例

ロイヤリティ報告用にラジオの再生ログを補完する

アーティスト名と曲名だけが記載された再生ログを貼り付け、「これらを ISRC、アルバム、レーベルに変換し、SoundExchange Report of Use に対応付けられる表を作って」と依頼します。アシスタントは 100 行ごとに resolve_tracks を呼び出し、著作権管理団体が照合に使う識別子を返します。PPL、Sena、GVL、Re:Sound の報告でも同様に使えます。

DJ ライブラリを整理する

「rekordbox のエクスポートから 50 曲を用意しました。それぞれの正規版を探し、同じ ISRC を共有する重複を示し、ジャンル、BPM、調をタグ付けしてください。」アシスタントは resolve_tracks と、各検索結果のジャンル、テンポ、調の情報を組み合わせて処理します。

録音を楽曲作品に結び付ける

「ディストリビューターからISRCを受け取りました。これらはどの楽曲作品に属し、それぞれの作品にはほかにどのような録音がありますか？」アシスタントはget_work_codesとget_recordings_of_workを連続して呼び出します。出版管理やカバー版・バージョンの調査に便利です。

プラットフォーム間での配信状況を確認する

「このBeatport限定トラックは、もうSpotifyでも配信されていますか？Beatport IDは6014288です。」get_platform_linksを1回呼び出すだけで、各プラットフォームへのディープリンク付きで確認できます。

レーベルを調査する

「過去6か月にAnjunabeatsがリリースした作品を、サブジャンル別にまとめてください。」アシスタントはget_label_releasesでページを順に取得し、トラックリストからジャンル情報を取り出します。

FAQ

無料プランはありますか？

はい。無料のSonoVaultキーでは、クレジットカードなしで月1,000件のリクエストを利用できます。browse_tracks以外のすべてのツールが利用できます。

各トラックにはどのようなメタデータが含まれますか？

タイトル、アーティストクレジット（メインアーティスト／リミキサーのフラグ付き）、ISRC、再生時間、BPM、調、ジャンルとサブジャンル、さらにリリースごとのアルバムタイトル、レーベル、リリース日です。ISWC作品コードは、専用の作品コード用ツールから取得します。

BPMや調は取得できますか？

はい。各トラックにはbpm（小数点以下最大2桁のフルテンポ。たとえば87ではなく174）と、次の3種類の表記による調が含まれます。

• key_alphanumeric：1〜12の数字に、短調ならA、長調ならBを付けます。たとえば10Bです。隣り合う数字同士、および同じ数字で文字が異なる調は、ハーモニックミキシングに適しています。
• key_musical：標準的な表記です。たとえばD、Am、F#m、Ebmです。
• key_open：Open Key表記です。小文字で、たとえば3d、1mです。

keysには、そのトラックについて取得したすべての調が、ソースごとに1件ずつ列挙されます。調はOpenKeyScanから、BPMはLexicon DJのビート検出器（10万人以上のDJに信頼されています）から取得し、どちらもSonoVaultが音声を解析して算出します。Daft Punkの「One More Time」は、123 BPM、10B／D／3dとして返されます。まだ解析されていないトラックでは、これらの値はすべてnull（keysは空）になります。エネルギーやダンサビリティなど、その他の音響特徴量は公開されていません。

データの取得元はどこですか？

MusicBrainz、Discogs、Spotify、Apple Music、Tidal、Beatportから集約・重複排除し、The MLCからISWCリンクを取得しています。詳細：sonovault.now/data-sources。

Spotify API連携とはどう違いますか？

単一プラットフォームのAPIが返すのは、そのプラットフォーム独自のIDだけです。SonoVaultは1つの録音を、ISRCをキーとして対応する7つの対応プラットフォームすべてのIDに解決し、さらに各プラットフォームのAPIでは公開されていない識別子（ISRC、ISWC）を追加します。比較：sonovault.now/compare/spotify-api。

APIキーはSonoVault以外にも送信されますか？

いいえ。サーバーはstdioを使ってローカルで動作し、キーはリクエストヘッダーとしてapi.sonovault.nowにのみ送信されます。コードは小規模で監査可能です：src/server.ts。

エージェントスキル

MCPを利用していませんか？skill/SKILL.mdは、あらゆるエージェントがHTTP経由でSonoVault APIを直接呼び出す方法を学べるAgent Skillです。検索ルール、ISRC／ISWCのレシピ、一括解決、エラー処理を扱います。

関連項目

• SonoVault APIのドキュメント
• sonovault-jsとsonovault-python、クライアントSDK（このサーバーはsonovault-jsを基盤に構築されています）

ライセンス

MIT