유튜브 MCP

Gemini AI를 사용하여 대본을 얻고, 콘텐츠를 요약하고, 비디오를 쿼리하는 도구를 제공하는 YouTube 비디오 분석을 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

• 📝 대본 추출 : YouTube 동영상에서 자세한 대본을 받으세요

• 📊 비디오 요약 : Gemini AI를 사용하여 간결한 요약을 생성합니다.

• ❓ 자연어 쿼리 : 비디오 콘텐츠에 대한 질문을 하세요

• 🔍 YouTube 검색 : 특정 검색어와 일치하는 동영상을 찾으세요

• 💬 댓글 분석 : 영상 댓글 검색 및 분석

요구 사항

• 파이썬 3.9 이상

• Google Gemini API 키

• YouTube 데이터 API 키

지역적으로 실행

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 youtube-mcp를 자동으로 설치하려면:

지엑스피1

옵션 1: 직접 설치

1. 저장소를 복제합니다.

   git clone https://github.com/Prajwal-ak-0/youtube-mcp cd youtube-mcp

2. 가상 환경을 만들고 종속성을 설치합니다.

   python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate pip install -e .

3. API 키로 .env 파일을 만듭니다.

   GEMINI_API_KEY=your_gemini_api_key YOUTUBE_API_KEY=your_youtube_api_key

4. MCP 서버를 실행합니다.

   python main.py

옵션 2: MCP CLI 사용

1. MCP CLI를 설치하세요:

   pip install mcp

2. 프로젝트에 mcp.json 파일을 만듭니다.

   { "youtube": { "command": "uv", "args": [ "--directory", "/absolute/path/to/youtube-mcp", "run", "main.py", "--transport", "stdio", "--debug" ] } }

3. MCP로 서버를 시작합니다.

   mcp run youtube

Docker와 함께 사용

1. Docker 이미지를 빌드합니다.

   docker build -t youtube-mcp .

2. API 키로 컨테이너를 실행합니다.

   docker run -e GEMINI_API_KEY=your_gemini_api_key -e YOUTUBE_API_KEY=your_youtube_api_key youtube-mcp

Smithery에 배치

이 MCP 서버는 Smithery 에 배포하여 더 쉽게 액세스할 수 있습니다.

1. Smithery에 서버를 추가하거나 신청하세요

2. Smithery 배포 탭에서 "배포"를 클릭하세요.

3. 메시지가 표시되면 API 키를 제공하세요

사용 가능한 도구

• youtube/get-transcript : 비디오 대본 받기

• youtube/summarize : 비디오 요약 생성

• youtube/query : 영상에 대한 질문에 답합니다

• youtube/search : 유튜브 영상 검색

• youtube/get-comments : 비디오 댓글 검색

• youtube/get-likes : 영상 좋아요 수를 가져옵니다

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.