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 스크로블 기반"). 각 항목은 resolve_music을 통해 스트리밍 및 구매 링크를 가져올 수 있는 BeatsVine 페이지로 연결됩니다.

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"
      }
    }
  ]
}

로드맵

• ✅ 음악 해석 — 라이브 (Spotify, Apple Music, iTunes, Amazon, Bandcamp, Discogs, YouTube Music, Tidal, Deezer 등에서 스트리밍, 디지털 구매, 바이닐, CD, 수집가용 에디션)

• ✅ 음악 탐색 — 라이브 (차트, 장르별, 분위기별 컬렉션, 에디토리얼 플레이리스트, 아티스트 스포트라이트 탐색)

• 🔜 게임 — 디지털 키, 물리적 복사본 및 수집가용 에디션 (Steam, PlayStation, Xbox, Nintendo, Epic, GOG)

• 🔜 도서 — 전자책, 오디오북, 페이퍼백, 하드커버 및 특별판 (Amazon, Bookshop.org, Apple Books, Kobo, Audible)

• 🔜 영화 및 TV — 스트리밍, 대여, 디지털 구매, DVD, Blu-ray 및 4K 스틸북

• 🔜 팟캐스트 — Apple Podcasts, Spotify, Pocket Casts 등에서 듣기 링크

• 🔜 라이브 이벤트 — 콘서트, 공연 및 페스티벌 티켓 (Ticketmaster, Dice, See Tickets)

중립성

RootVine은 엄격한 중립 정책을 따릅니다:

• 순위는 신뢰 등급 → 가격 → 가용성 → 최신성 → 판매자 ID에 의해 결정됩니다.

• 수수료율, 제휴 네트워크 및 스폰서 표시는 순위 결정 함수에서 구조적으로 제외됩니다.

• 순위 결정 로직은 서버 측에서 실행되며, 이 패키지는 씬 클라이언트입니다.

라이선스

MIT — © Raging Orangutan Holdings