Rootvine Mcp

rootvine-mcp

面向 AI Agent 的中立商业解析层。通过 Model Context Protocol，将 Claude、ChatGPT 和其他 AI Agent 连接到可信的产品与媒体数据，覆盖从流媒体到典藏版的所有购买途径。

功能

当用户向 AI Agent 提问“在哪里可以收听 Aphex Twin 的《Windowlicker》？”时，RootVine 会在所有主流流媒体、购买和实体平台中解析查询，并返回带有直达链接的排序结果。

同一套基础设施也能满足完整的购买需求：在线播放、数字版购买，或查找黑胶唱片。音乐功能现已上线。游戏、书籍、电影、播客和现场活动等垂直领域将随着各自的功能推出而陆续上线。

**没有广告。没有赞助展示位。没有付费排名。**结果依据中立、确定性的算法排序：信任等级 → 价格 → 可用性 → 新鲜度 → 商家 ID。佣金率、联盟网络和赞助标记在架构上均被排除在排序函数之外。

快速开始

托管版——无需安装

RootVine 以托管式、可流式传输的 HTTP MCP 服务运行：

https://mcp.rootvine.ai/mcp

在任何支持远程 MCP 服务的客户端中，通过 URL 添加即可——例如，在 claude.ai 中选择：设置 → 连接器 → 添加自定义连接器。无需登录，也无需密钥。提供与 npm 包相同的五种工具，并从相同的实时数据源获取答案。

隐私：托管端点会记录调用了哪个工具，但绝不会记录你的地址或提问内容。当它在 BeatsVine 上查找内容时，会传递一个调用者匿名 ID，以便 BeatsVine 统计有多少不同的人询问了尚无对应页面的歌曲。该 ID 是一个每三个月更换一次的密钥哈希，绝不是地址；每位 claude.ai 用户都只计作一个调用者。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”。切勿自行构造 slug：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”），则会返回这些录音供用户选择，而不是随机挑选一个。

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，而不是猜测。

有两个响应字段值得留意：

• 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 }

模式（由设置的参数决定）：

• 入口（不带参数）——所有分区和精选专区的概览
• 分区（chamber 参数）——列出某个分区内的专区（例如所有流派长廊）
• 专区（wall 参数：slug、walls/slug 或专区地址）——查看特定专区中的曲目、专辑或艺人
• 档案（year 参数）——自 1946 年以来任意年份的排行榜定格快照

返回： 附有明确来源说明的精选合集（例如“由 Deezer 编辑团队精选”“基于 Last.fm 播放记录”）。每个条目都附有 query，可通过 resolve_music 获取流媒体和购买链接。

回答“我出生那年谁是冠军——在哪里能买到”：

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 会获取排行榜页面中标注的冠军对应页面——不进行搜索，也不猜测名称。如果这些链接响应较慢，排行榜仍会返回，并附带说明。

档案：完整收录美国 Billboard 年终 Hot 100 榜单，可追溯至 1946 年，另有实时排行榜的每周快照。英国年终榜单仅显示冠军，并附有指向 officialcharts.com 完整榜单的链接（Official Charts Company 编制的内容受数据库权保护）；每个专区都会在其 publication 字段中说明这一点。全球年度和十年榜单与美国 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 时都确实存在。

每个答案都会以两种形式返回：易读文本，以及 structuredContent（MCP 结构化输出），二者包含相同的信息，因此 Agent 可以读取字段，而不必解析散文。失败会返回纯文本错误（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——绝不会是零，也绝不会是“免费”。
• 仅当确认 BeatsVine 页面存在时，才会提供 page_url。
• 限制：面向英国的商店，价格以 GBP 计；目前仅支持音乐。

路线图

• ✅ 音乐查询 — 已上线（流媒体、数字购买、黑胶、CD、收藏版，覆盖 Spotify、Apple Music、iTunes、Amazon、Bandcamp、Discogs、YouTube Music、Tidal、Deezer 等平台）
• ✅ 音乐发现 — 已上线（浏览排行榜、流派专题、情绪合集、编辑精选播放列表、艺人专题）
• ✅ 排行榜存档 — 已上线（从 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