@pipeworx/genius

Genius MCP — 노래 / 아티스트 / 앨범 메타데이터, 검색, Genius 어노테이션 설명을 제공합니다. Genius API는 라이선스 문제로 가사 텍스트를 반환하지 않습니다 — 이 팩은 제목, ID, 통계, Genius 페이지 URL, "about" 설명을 반환합니다.

Pipeworx의 일부 — AI 에이전트를 1476개 이상의 실시간 데이터 소스에 연결하는 MCP 게이트웨이입니다.

도구

• search(query, limit?) — 키워드 검색; 노래 메타데이터 결과를 반환합니다

• get_song(id) — 노래 메타데이터 (title, artist, album, release, pageviews, about)

• get_artist(id) — 아티스트 메타데이터 (name, followers, alternate names, about)

• artist_songs(artist_id, limit?) — 아티스트의 노래 목록, 인기순 정렬

_apiKey는 모든 도구에서 선택 사항입니다 — 생략하면 플랫폼 키를 사용합니다.

Related MCP server: mcp-lyrics-ovh

인증

• 플랫폼 키: _apiKey를 생략하면 게이트웨이가 주입합니다.

• BYO: https://genius.com/api-clients에서 무료 Client Access Token을 등록한 후 _apiKey=<token>을 전달하세요.

모든 요청에 Authorization: Bearer <token>으로 전송됩니다.

데이터 소스

https://api.genius.com — Bearer 액세스 토큰.

빠른 시작

MCP 클라이언트(Claude Desktop, Cursor, Windsurf 등)에 추가하세요:

{
  "mcpServers": {
    "genius": {
      "url": "https://gateway.pipeworx.io/genius/mcp"
    }
  }
}

이 엔드포인트가 실제로 제공하는 것

https://gateway.pipeworx.io/genius/mcp의 tools/list는 위 표의 도구들에 Pipeworx 공용 메타 도구들 — ask_pipeworx, discover_tools, search_within, remember/recall 및 나머지 게이트웨이 전체 세트 — 을 더해 반환합니다. 따라서 표시되는 도구 수는 이 표보다 많습니다: 단일 팩 엔드포인트는 현재 자체 도구와 함께 약 30개의 공용 도구를 나열합니다. 연결의 initialize 응답은 정확한 범위를 명시하며, 해당 시점의 확정적인 답변입니다.

이는 의도된 설계이지, 우연한 멀티플렉싱이 아닙니다. 메타 도구 덕분에 범위가 제한된 연결에서도 이 팩이 다루지 않는 질문에 — 전체 카탈로그를 라우팅하는 ask_pipeworx를 통해 — 답할 수 있으며, 두 번째 MCP 서버를 추가할 필요가 없습니다. 현재는 메타 도구 없이 팩 엔드포인트를 마운트할 방법이 없습니다. 추가 스키마가 라우팅의 가치보다 더 많은 컨텍스트를 소모한다면, 여러 팩 엔드포인트에 연결하는 대신 전체 게이트웨이에 한 번 연결하세요.

또는 전체 Pipeworx 게이트웨이에 연결하여 이 팩의 도구만이 아니라 모든 팩의 도구가 직접 나열되게 할 수 있습니다:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

두 URL 모두 동일한 게이트웨이와 동일한 1476개 이상의 데이터 소스에 연결됩니다. 유일한 차이는 어떤 팩의 도구가 직접 나열되는지입니다. ask_pipeworx는 어느 쪽에서든 모든 도구에 접근할 수 있습니다.

ask_pipeworx와 함께 사용하기

도구를 직접 호출하는 대신 일반 영어로 질문할 수 있습니다 — 이 기능은 위의 팩 엔드포인트와 전체 게이트웨이 모두에서 작동합니다:

ask_pipeworx({ question: "your question about Genius data" })

게이트웨이가 올바른 도구를 선택하고 인수를 자동으로 채웁니다.

더보기

• 문서 및 가이드

• pipeworx.io

라이선스

MIT