Rootvine Mcp

rootvine-mcp

AI エージェント向けの中立的なコマース解決レイヤーです。Model Context Protocol を介して Claude、ChatGPT、その他の AI エージェントを信頼できる商品・メディアデータにつなぎ、ストリーミングからコレクターズエディションまで、あらゆる入手方法をカバーします。

概要

ユーザーが AI エージェントに「Aphex Twin の Windowlicker はどこで聴けますか？」と尋ねると、RootVine は主要なストリーミング、購入、現物販売の各プラットフォームを横断してクエリを解決し、直接リンク付きのランキング結果を返します。

同じインフラが、購入方法の全段階に対応します。ストリーミングで聴く、デジタル版を購入する、またはレコードを探すことができます。音楽は本日から利用できます。ゲーム、本、映画、ポッドキャスト、ライブイベントは、それぞれの分野の提供開始に合わせて順次追加されます。

広告なし。スポンサー枠なし。金銭による順位操作なし。 結果は、中立的かつ決定論的なアルゴリズムで順位付けされます。信頼度 → 価格 → 入手可能性 → 新しさ → 販売者 ID の順です。コミッション率、アフィリエイトネットワーク、スポンサーのフラグは、アーキテクチャ上、ランキング関数から除外されています。

クイックスタート

ホスト型 — インストール不要

RootVine は、ホスト型のストリーミング可能な HTTP MCP サーバーとして動作します。

https://mcp.rootvine.ai/mcp

リモート MCP サーバーに対応する任意のクライアントで、URL を使って追加できます。たとえば claude.ai では、Settings → Connectors → Add custom connector を選択します。ログインもキーも不要です。npm パッケージと同じ 5 つのツールで、同じライブソースから回答します。

プライバシー：ホスト型エンドポイントは、呼び出されたツールを記録しますが、あなたの住所や質問内容は記録しません。BeatsVine を検索するときは、呼び出し元を示す匿名 ID を渡します。これにより BeatsVine は、まだページがない曲について、何人の異なるユーザーが尋ねたかを数えられます。この ID は 3 か月ごとに変わるキー付きハッシュであり、住所ではありません。また、claude.ai のユーザーは全員、1 人の呼び出し元として数えられます。npm パッケージはこのような ID を送信しません。

Claude Desktop（ローカル、npm 経由）

Claude Desktop の設定（~/.claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "rootvine": {
      "command": "npx",
      "args": ["-y", "rootvine-mcp"]
    }
  }
}

Claude Desktop を再起動してください。次のように尋ねられるようになります。

• 「Ed Sheeran の Galway Girl はどこでストリーミングできますか？」
• 「Aphex Twin の Windowlicker はどこで聴けますか？」
• 「Kendrick Lamar の新しいアルバムへのリンクを探して」

その他の MCP クライアント

MCP 対応クライアントならどれでも、stdio トランスポート経由で rootvine-mcp を利用できます。

npx rootvine-mcp

ツール

ユーザー自身の言葉を query として渡してください（「galway girl by ed sheeran」、「what albums has Stromae released」など）。スラッグは作成しないでください。RootVine がページを探します。slug は非推奨の query の別名として引き続き利用できます（どちらか一方を送信し、両方は送信しないでください）。

resolve_music

曲やアルバムをストリーミング、購入、またはコレクションする方法を探します。

入力： { query: "galway girl by ed sheeran" } — ユーザー自身の言葉、BeatsVine のページアドレス、または以前の回答に含まれる query の値です。

戻り値： 以下を網羅したランキング結果です。

• ストリーミング — Spotify、Apple Music、Tidal、YouTube Music、Deezer
• デジタル購入 — iTunes Store、Amazon Music、Bandcamp
• 現物メディア — レコード、CD（Amazon 経由）、Discogs のコレクター向け出品

すべての結果に、価格（入手可能な場合）、直接リンク、トラッキング用のアフィリエイトタグ付きクリック URL が含まれます。

ページの検索方法： RootVine は、重要な語句（「where can I stream」のようなリクエスト語や、「by」のようなつなぎ語は除外）を使って BeatsVine のカタログを検索し、最も一致するページを開きます。誤字がある場合は BeatsVine のライブ検索で修正され、RootVine は実際のページを開き、そのことを resolved_as（corrected: true）で示します。確度の低い推測を回答として提示することはありません。一致しない場合は status: "no_results" と did_you_mean（それぞれ query を渡せる近似候補）を返します。複数のアーティストが録音したタイトルをアーティスト名なしで尋ねた場合（「shape of you」など）は、ランダムに 1 つを選ぶのではなく、選択できる録音を返します。

resolve_artist

アーティストのプロフィールと全ディスコグラフィーを取得します。

入力： { query: "Stromae" } — 名前、BeatsVine のアーティストアドレス、または artist/stromae

戻り値： ジャンル、アーティストのメタデータ、BeatsVine が取り扱うすべてのリリース。それぞれに resolve_music ですぐに使える query が含まれます。

resolve_artist { query: "Stromae" }
  → 19 releases, e.g. album/stromae-racine-carre

resolve_music { query: "album/stromae-racine-carre" }
  → stream, purchase and physical-media links

レコード、CD、Discogs の出品といった物理フォーマットはアルバム単位の商品です。そのため、コレクター向けエディションを探す場合はこちらを使います。名前のスペルが間違っている場合は、推測ではなく did_you_mean が返されます。

扱いに注意したいレスポンスフィールドが 2 つあります。

• discography_complete: false（BeatsVine の not_yet_indexed）は、BeatsVine がまだこのアーティストをカタログに登録していないことを意味します。この場合、空のリストは「リリースがない」ではなく「不明」を意味します。その旨は、ディスコグラフィーが空であると誤解させないよう、テキストでも明示されています。
• sparse_fallback_applied は、アルバムのリストが少ないためにシングルが含まれたことを意味します。これは BeatsVine の表示上の判断であり、アーティスト自身の見解と誤解されないよう、フィールドとして示されます。

discover_music

チャート、ジャンル別一覧、ムード、編集プレイリスト、アーティスト特集、1946 年まで遡る過去のチャートなど、厳選された音楽コレクションを閲覧します。

入力： { chamber?: "by-genre" | "for-this-moment" | "charts" | "by-era" | "spotlights", wall?: string, year?: number, limit?: number, resolve?: boolean }

モード（設定された引数によって選ばれます）：

• Foyer（引数なし）— すべての区画と注目の一覧の概要
• Chamber（chamber 引数）— 区画内の一覧を表示します（例：すべてのジャンル別一覧）
• Wall（wall 引数：スラッグ、walls/slug、または一覧のアドレス）— 特定の一覧に含まれるトラック、アルバム、アーティストを表示します
• Archive（year 引数）— 1946 年以降の任意の年の、保存されたチャートスナップショット

戻り値： 出典を明示した厳選コレクション（例：「Deezer の編集チームが選定」「Last.fm の再生記録に基づく」）。各項目には query が含まれており、resolve_music を使ってストリーミングや購入のリンクを取得できます。

「生まれた年の 1 位の曲は何で、どこで入手できますか？」に答える場合：

discover_music { year: 1994 }                                       → bv-year-end-hot-100-1994 (100 entries)
discover_music { wall: "bv-year-end-hot-100-1994", resolve: true }  → number one = Ace of Base, "The Sign", with its links

resolve: true を指定すると、検索したり名前を推測したりせず、チャート自体が 1 位として示すページを取得します。リンクの取得に時間がかかる場合でも、注記とともにチャートが返されます。

アーカイブには、1946 年まで遡る米国の Billboard 年末 Hot 100 全曲に加えて、現在のチャートの週次スナップショットが含まれます。英国の年末チャートでは 1 位のみが表示され、全チャートへのリンクは officialcharts.com に掲載されます（Official Charts Company による編集物はデータベース権で保護されています）。各一覧の publication フィールドにその旨が記載されています。世界の年間・10 年間の一覧は、米国の Billboard チャートを反映しています。

find_product

スマートルーターです。ユーザーの言葉からカテゴリーを判定し、適切なリゾルバーに振り分けます。

入力： { query: "Aphex Twin Windowlicker", category: "auto" }

判定はキーワードに基づきます。音楽関連の語（「album」「vinyl」「song」「by」など）はゲーム関連の語より優先されるため、「Abbey Road deluxe edition vinyl」は音楽として判定されます。カテゴリーがわかっている場合は、category を設定してください。

戻り値： 選択されたツールの回答です。現在、音楽の検索結果（ストリーミング、デジタル購入、レコード、CD、コレクター向けエディション）が利用できます。ゲームについては「近日公開」と回答します。書籍、映画、ポッドキャスト、ライブイベントのチケットは、各カテゴリーのサービス開始に合わせて自動的に振り分けられます。

resolve_game (近日公開)

Steam、PlayStation、Xbox、Nintendo、Epic、GOG、Humble、Fanatical のゲーム価格を照合します。このツールは登録されていますが、まだ有効ではありません。ゲームカテゴリーのサービスが開始されるまでは、明示的に「近日公開」と返します（リンク、価格は含まれず、リクエストも行われません）。

回答形式

RootVine が情報を捏造することはありません。すべてのリンクは resolved_at 時点で存在していました。

回答は必ず 2 つの形式で返されます。読みやすいテキストと、同じ事実を含む structuredContent（MCP の構造化出力）です。これにより、エージェントは文章を解析せず、フィールドを読み取れます。失敗はプレーンテキストのエラー（isError）として返されます。見つからなかった場合はエラーではなく、回答（no_results）です。

resolve_music の回答例（抜粋）：

{
  "status": "success",
  "artist": "Ed Sheeran",
  "title": "Galway Girl",
  "kind": "track",
  "results": [
    {
      "rank": 1,
      "merchant": "Spotify",
      "type": "stream",
      "trust_tier": "authoritative",
      "availability": "available",
      "price": null,
      "click_url": "https://www.beatsvine.com/r/abc123",
      "url": "https://open.spotify.com/track/...",
      "ranking_reason": { "code": "FREE_STREAM_T1", "summary": "Stream with no listed price, Tier 1" }
    }
  ],
  "partial_sources": [],
  "warnings": [],
  "resolved_as": { "query": "ed-sheeran-galway-girl", "via": "catalogue_search", "corrected": false, "note": null },
  "did_you_mean": [],
  "page_url": "https://www.beatsvine.com/ed-sheeran-galway-girl",
  "response_id": "rv_resp_...",
  "resolved_at": "2026-09-26T12:00:00.000Z",
  "ttl_seconds": 86400
}

• status は success、partial（実在するものの不完全です。回答がなかったものは partial_sources に記載されます）、または no_results です。
• 価格がない場合は null です。ゼロや「無料」にはなりません。
• page_url が提示されるのは、BeatsVine のページが存在すると確認された場合のみです。
• 制限：英国に重点を置いたストア、価格は GBP、現在は音楽のみです。

ロードマップ

• ✅ 音楽の解決 — 提供中（Spotify、Apple Music、iTunes、Amazon、Bandcamp、Discogs、YouTube Music、Tidal、Deezer などでのストリーミング、デジタル購入、レコード、CD、コレクターズエディション）
• ✅ 音楽の発見 — 提供中（チャート、ジャンル別一覧、ムード別コレクション、編集者選定のプレイリスト、アーティスト特集の閲覧）
• ✅ チャートアーカイブ — 提供中（1946 年まで遡る年末および週間チャートの保存スナップショット — Billboard Hot 100、Global Top 100、UK Singles）
• ✅ アーティストのディスコグラフィー — 提供中（アーティストプロフィールとリリース一覧。各項目からストリーミング、購入、コレクション関連のリンクを解決できます）
• 🔜 ライブイベント — コンサート、ライブ、フェスティバルのチケット
• 🔜 ゲーム — デジタルキー、パッケージ版、コレクターズエディション（Steam、PlayStation、Xbox、Nintendo、Epic、GOG）
• 🔜 書籍 — 電子書籍、オーディオブック、ペーパーバック、ハードカバー、特別版（Amazon、Bookshop.org、Apple Books、Kobo、Audible）
• 🔜 映画・テレビ — ストリーミング、レンタル、デジタル購入、DVD、Blu-ray、4K スチールブック
• 🔜 ポッドキャスト — Apple Podcasts、Spotify、Pocket Casts などの再生リンク

中立性

RootVine は厳格な中立性ポリシーに従っています。

• ランキングは 信頼度 → 価格 → 在庫状況 → 情報の新しさ → マーチャント ID に基づいて決まります。
• コミッション率、アフィリエイトネットワーク、スポンサー付きの表示は、ランキング関数から設計上除外されています。
• ランキング処理はサーバー側で実行されます。このパッケージは薄いクライアントです。

ライセンス

MIT — © Raging Orangutan Holdings