YouTube 뮤직 MCP 서버

개요

이 프로젝트는 AI 모델이 Google Chrome을 통해 YouTube Music 재생을 제어할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버를 구현합니다. AI 비서와 음악 재생 간의 간극을 메워 AI가 노래 이름과 아티스트 이름을 기반으로 노래를 검색하고 재생할 수 있도록 합니다.

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 AI 모델이 외부 도구 및 서비스와 상호 작용하는 표준화된 방식입니다. AI 비서가 다음과 같은 작업을 수행할 수 있도록 구조화된 통신 프로토콜을 제공합니다.

• 사용 가능한 도구 알아보기
• 도구 기능 이해
• 이러한 도구를 통해 작업을 실행하세요
• 응답과 오류를 일관되게 처리합니다.

MCP에 대해 자세히 알아보세요.

• MCP 문서
• MCP SDK

특징

• YouTube Music에서 노래를 검색하세요
• Google Chrome에서 직접 노래 재생
• 곡명 및 아티스트명 검색 지원
• 오류 처리 및 로깅
• 크로스 플랫폼 지원(Chrome 자동화를 위한 macOS 중심)

건축학

상위 수준 개요

유튜브 뮤직 서버 MCP 서버

모델 컨텍스트 프로토콜 서버

간단한 메모 시스템을 구현하는 TypeScript 기반 MCP 서버입니다. 다음을 제공하여 핵심 MCP 개념을 보여줍니다.

• URI 및 메타데이터를 사용하여 텍스트 노트를 나타내는 리소스
• 새로운 노트를 만드는 도구
• 노트 요약 생성을 위한 프롬프트

특징

자원

• note:// URI를 통해 메모를 나열하고 액세스합니다.
• 각 노트에는 제목, 내용 및 메타데이터가 있습니다.
• 간단한 콘텐츠 액세스를 위한 일반 텍스트 MIME 유형

도구

• create_note - 새로운 텍스트 노트 만들기
  • 제목과 내용을 필수 매개변수로 사용합니다.
  • 서버 상태에 메모 저장

프롬프트

• summarize_notes - 저장된 모든 노트의 요약을 생성합니다.
  • 모든 노트 내용을 내장 리소스로 포함합니다.
  • LLM 요약을 위한 구조화된 프롬프트를 반환합니다.

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

설치

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.