rootvine-mcp

一个面向 AI 代理的中立商业解析层。通过 Model Context Protocol 将 Claude、ChatGPT 及其他 AI 代理连接到可信的产品和媒体数据，涵盖从流媒体到收藏版的所有路径。

功能概述

当用户询问 AI 代理“我在哪里可以听 Aphex Twin 的 Windowlicker？”时，RootVine 会在所有主流流媒体、购买和实体平台中解析该查询，并返回带有直接链接的排名结果。

同样的架构可以回答完整的购买需求：流媒体播放、数字购买或查找黑胶唱片。音乐功能现已上线。游戏、书籍、电影、播客和现场活动等垂直领域将在上线后陆续推出。

无广告。无赞助排名。无付费排名。 结果由中立的确定性算法进行排名：信任等级 → 价格 → 可用性 → 时效性 → 商家 ID。佣金率、联盟网络和赞助标记在架构上被排除在排名函数之外。

快速入门

Claude Desktop

添加到您的 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

工具

discover_music

浏览精选音乐合集——排行榜、流派墙、心情、编辑播放列表和艺术家精选。

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

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

• 大厅 (Foyer)（无参数）——所有展厅和特色墙的概览

• 展厅 (Chamber) (chamber 参数) ——列出展厅内的墙（例如所有流派走廊）

• 墙 (Wall) (wall 参数) ——深入查看特定墙的曲目、专辑或艺术家

返回： 带有真实归属的精选合集（例如“由 Deezer 编辑团队精选”、“基于 Last.fm 记录”）。每个条目都链接到一个 BeatsVine 页面，其流媒体和购买链接可通过 resolve_music 获取。

resolve_music

查找流媒体播放、购买或收藏歌曲或专辑的途径。

输入： { slug: "ed-sheeran-galway-girl" }

返回： 涵盖以下内容的排名结果：

• 流媒体 — Spotify, Apple Music, Tidal, YouTube Music, Deezer

• 数字购买 — iTunes Store, Amazon Music, Bandcamp

• 实体媒体 — 黑胶唱片, CD (通过 Amazon), Discogs 收藏列表

每个结果都包含价格（如有）、直接链接以及用于追踪的联盟标签点击 URL。

resolve_game (即将推出)

Steam、PlayStation、Xbox、Nintendo、Epic、GOG、Humble 和 Fanatical 的游戏价格解析。此工具已注册但尚未激活——在游戏垂直领域上线前，它将返回“即将推出”的响应。

find_product

智能路由——自动检测类别并路由到正确的解析器。

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

返回： 目前为音乐结果（流媒体、数字购买、黑胶唱片、CD、收藏版）。游戏、书籍、电影、播客和现场活动门票将在各垂直领域上线时自动路由。

响应格式

所有结果均遵循 RootVine v1 规范：

{
  "rootvine": {
    "version": "1.0",
    "resolver": "beatsvine",
    "category": "music"
  },
  "status": "success",
  "query": {
    "type": "music",
    "artist": "Aphex Twin",
    "title": "Windowlicker"
  },
  "results": [
    {
      "rank": 1,
      "merchant": "Spotify",
      "trust_tier": "authoritative",
      "price": null,
      "url": "https://open.spotify.com/track/...",
      "click_url": "https://beatsvine.com/r/abc123",
      "type": "stream",
      "ranking_reason": {
        "code": "FREE_STREAM_T1",
        "summary": "Free stream from authoritative source"
      }
    }
  ]
}

路线图

• ✅ 音乐解析 — 已上线（流媒体、数字购买、黑胶唱片、CD、收藏版，涵盖 Spotify, Apple Music, iTunes, Amazon, Bandcamp, Discogs, YouTube Music, Tidal, Deezer 等）

• ✅ 音乐发现 — 已上线（浏览排行榜、流派墙、心情合集、编辑播放列表、艺术家精选）

• 🔜 游戏 — 数字密钥、实体拷贝和收藏版 (Steam, PlayStation, Xbox, Nintendo, Epic, GOG)

• 🔜 书籍 — 电子书、有声书、平装书、精装书和特别版 (Amazon, Bookshop.org, Apple Books, Kobo, Audible)

• 🔜 电影与电视 — 流媒体、租赁、数字购买、DVD、蓝光和 4K 铁盒版

• 🔜 播客 — Apple Podcasts, Spotify, Pocket Casts 等平台的收听链接

• 🔜 现场活动 — 演唱会、演出和音乐节门票 (Ticketmaster, Dice, See Tickets)

中立性

RootVine 遵循严格的中立政策：

• 排名由 信任等级 → 价格 → 可用性 → 时效性 → 商家 ID 决定

• 佣金率、联盟网络和赞助标记在架构上被排除在排名函数之外

• 排名逻辑在服务器端运行——此包仅为轻量级客户端

许可证

MIT — © Raging Orangutan Holdings