YouTube Music MCP
🎵 AI 어시스턴트가 YouTube Music에서 트랙을 검색하고 재생할 수 있도록 해주는 MCP(Model Context Protocol) 서버입니다.
개요
이 스킬은 MCP 프로토콜을 통해 YouTube Music과의 통합을 제공합니다. 노래 제목이나 아티스트 이름으로 음악을 검색하고, 사용자의 기본 웹 브라우저에서 바로 재생할 수 있습니다.
사용 가능한 도구
- searchTrack - YouTube Music에서 노래 제목이나 아티스트 이름으로 음악 트랙을 검색합니다.
- playTrack - 트랙을 검색하고 자동으로 기본 웹 브라우저에서 엽니다.
사전 요구 사항
이 스킬을 사용하기 전에 다음을 준비하세요.
- Google Cloud Console에서 유효한 Google YouTube API 키
- Cursor 또는 Claude Desktop이 올바르게 구성되어 있어야 함
설치
.cursor/mcp.json 파일(또는 Claude Desktop 설정)에 다음 구성을 추가하세요.
{
"mcpServers": {
"youtube-music-mcp": {
"command": "npx",
"args": ["-y", "@instructa/mcp-youtube-music"],
"env": {
"YOUTUBE_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
<YOUR_API_KEY>를 실제 YouTube API 키로 바꾸세요.
사용 예
트랙 검색하기
사용자: "퀸의 보헤미안 랩소디를 검색해줘"
어시스턴트: [searchTrack 도구를 사용해 YouTube Music에서 트랙을 찾음]
트랙 재생하기
사용자: "재즈 음악 좀 틀어줘"
어시스턴트: [playTrack 도구를 사용해 재즈 음악을 검색하고 브라우저에서 엶]
가이드라인
- 도구를 사용하기 전에 YouTube API 키가 구성되었는지 항상 확인하세요.
- 어떤 트랙이 발견되었거나 재생되었는지 사용자에게 명확하게 피드백을 제공하세요.
- 트랙을 찾을 수 없는 경우 대체 검색어나 아티스트를 제안하세요.
- playTrack 도구는 사용자의 기본 웹 브라우저에서 트랙을 엽니다.
- 사용자의 음악 장르 및 아티스트 선호도를 존중하세요.
기술 세부 사항
- 프로토콜: Model Context Protocol (MCP)
- 플랫폼: YouTube Music
- 실행 방식: 로컬 설치 없이
npx를 통해 실행 - 라이선스: MIT
작성자
Kevin Kern / Instructa (@kregenrek)
리소스
- GitHub 저장소: instructa/mcp-youtube-music
- 더 알아보기: instructa.ai