rootvine-mcp

Нейтральный уровень разрешения коммерческих данных для ИИ-агентов. Подключает Claude, ChatGPT и другие ИИ-агенты к проверенным данным о продуктах и медиа через Model Context Protocol — охватывая все пути от стриминга до коллекционных изданий.

Что это делает

Когда пользователь спрашивает ИИ-агента: «Где я могу послушать Windowlicker от Aphex Twin?», RootVine разрешает этот запрос по всем основным стриминговым, торговым и физическим платформам и возвращает ранжированные результаты с прямыми ссылками.

Та же инфраструктура отвечает на полный цикл покупки: прослушивание, цифровая покупка или поиск винила. Музыка доступна уже сегодня. Игры, книги, фильмы, подкасты и живые мероприятия будут добавлены по мере запуска соответствующих вертикалей.

Никакой рекламы. Никаких спонсорских размещений. Никакого ранжирования за деньги. Результаты ранжируются по нейтральному детерминированному алгоритму: уровень доверия → цена → доступность → актуальность → ID продавца. Комиссионные ставки, партнерские сети и спонсорские метки архитектурно исключены из функции ранжирования.

Быстрый старт

Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/.claude/claude_desktop_config.json):

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

Перезапустите Claude Desktop. Теперь вы можете спрашивать:

• «Где я могу послушать Galway Girl от Ed Sheeran?»

• «Где я могу послушать Windowlicker от Aphex Twin?»

• «Найди ссылки на новый альбом Kendrick Lamar»

Другие MCP-клиенты

Любой MCP-совместимый клиент может использовать rootvine-mcp через транспорт stdio:

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, Blu-ray и 4K steelbook

• 🔜 Подкасты — ссылки на прослушивание в Apple Podcasts, Spotify, Pocket Casts и других

• 🔜 Живые мероприятия — билеты на концерты, выступления и фестивали (Ticketmaster, Dice, See Tickets)

Нейтральность

RootVine придерживается строгой политики нейтральности:

• Ранжирование определяется по принципу уровень доверия → цена → доступность → актуальность → ID продавца

• Комиссионные ставки, партнерские сети и спонсорские метки архитектурно исключены из функции ранжирования

• Логика ранжирования выполняется на стороне сервера — этот пакет является «тонким» клиентом

Лицензия

MIT — © Raging Orangutan Holdings