YouTube MCP 서버

이는 Claude와 다른 AI 비서들이 YouTube API와 상호작용할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다. 이 서버는 동영상 검색, 특정 동영상에 대한 세부 정보 확인, 채널 검색, 그리고 채널에 대한 자세한 정보를 얻을 수 있는 도구를 제공합니다.

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 클로드(Claude)를 개발한 Anthropic이 개발한 개방형 표준으로, AI 비서를 외부 데이터 소스 및 도구와 연결하기 위해 사용됩니다. 클로드와 같은 모델이 최신 정보에 접근하고 표준화된 방식으로 외부 시스템에서 작업을 수행할 수 있도록 지원합니다.

MCP는 AI를 위한 "범용 브리지" 역할을 하며, 모델이 다양한 콘텐츠 저장소, 비즈니스 서비스 또는 애플리케이션에 액세스할 수 있는 표준화된 방식을 제공합니다.

요구 사항

• Node.js v16 이상
• YouTube API 키(Google 개발자 콘솔에서 획득)

설치

1. 이 저장소를 복제하세요:

지엑스피1

2. 종속성 설치:

3. 프로젝트 루트에 .env 파일을 만들고 YouTube API 키를 추가하세요.

실행

서버를 시작하려면 다음을 실행하세요.

Claude Desktop과 통합

Claude Desktop과 함께 이 MCP 서버를 사용하려면 다음 구성을 claude_desktop_config.json 파일에 추가하세요(일반적으로 Windows에서는 %APPDATA%\Claude\ 에 있고 macOS에서는 ~/Library/Application Support/Claude/ 에 있음).

"path/to/youtube-mcp-server/index.js" index.js 파일의 절대 경로로 바꾸고, "your_api_key_here" YouTube API 키로 바꾸세요.

사용 가능한 도구

1. 비디오 검색

검색어를 기반으로 YouTube에서 동영상을 검색합니다.

매개변수:

• query (문자열, 필수): 검색어
• maxResults (숫자, 선택 사항): 최대 결과 수(1~50)
• pageToken (문자열, 선택 사항): 다음 페이지 결과를 가져오기 위한 토큰

2. 비디오 세부 정보 얻기

특정 비디오에 대한 자세한 정보를 얻으세요.

매개변수:

• videoId (문자열, 필수): YouTube 비디오 ID

3. 채널 세부 정보 가져오기

특정 채널에 대한 자세한 정보를 얻으세요.

매개변수:

• channelId (문자열, 필수): YouTube 채널 ID

4. 채널 검색

검색어를 기반으로 YouTube에서 채널을 검색합니다.

매개변수:

• query (문자열, 필수): 검색어
• maxResults (숫자, 선택 사항): 최대 결과 수(1~50)
• pageToken (문자열, 선택 사항): 다음 페이지 결과를 가져오기 위한 토큰

사용 가능한 리소스

• youtube://popular/videos : 현재 YouTube에서 인기 있는 동영상 목록

사용 예

Claude Desktop을 사용하면 다음과 같은 질문을 할 수 있습니다.

• "Python 프로그래밍 비디오 검색"
• "ID dQw4w9WgXcQ의 비디오 세부 정보를 보여주세요"
• "요리 관련 채널 검색"
• "Google Developers 채널에 대한 정보를 알려주세요"
• "지금 가장 인기 있는 영상은 무엇인가요?"

YouTube API 키 받기

YouTube API 키를 받으려면:

1. Google 개발자 콘솔 로 이동
2. 새 프로젝트를 생성하세요(또는 기존 프로젝트를 선택하세요)
3. 사이드바에서 "API 라이브러리"를 선택하세요
4. "YouTube Data API v3"를 검색하여 활성화하세요.
5. 사이드바에서 "자격 증명"을 선택하세요.
6. "자격 증명 만들기"를 클릭하고 "API 키"를 선택하세요.
7. 생성된 키를 복사하여 .env 파일이나 Claude Desktop 구성에서 사용하세요.

문제 해결

오류가 발생하면 다음을 확인하세요.

1. npm install 사용하여 모든 종속성을 설치했는지 확인하십시오.
2. YouTube API 키가 유효합니다
3. Google 프로젝트에서 YouTube Data API v3가 활성화되어 있는지 확인하세요.
4. Node.js 버전 16 이상을 사용하고 있습니다.
5. Claude Desktop을 사용하는 경우 %APPDATA%\Claude\logs\ (Windows) 또는 ~/Library/Logs/Claude/ (macOS)에서 로그를 확인하세요.

기여

여러분의 참여를 환영합니다. 다양한 방법으로 협업하실 수 있습니다.

1. 버그 또는 문제 보고
2. 새로운 기능 제안
3. 개선 사항이나 수정 사항을 포함하는 풀 리퀘스트 보내기
4. 문서 개선

연결 및 지원

• X(트위터)에서 저를 팔로우하세요: @Nocodeboy
• 이 프로젝트가 유용하다고 생각하시고 지원을 원하신다면:

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.