YouTube MCP Server

by icraft2170
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Requires setup of a YouTube Data API v3 key through Google Cloud Console to authenticate and access YouTube data.

  • Provides tools for retrieving video details, searching videos, getting transcripts, analyzing channels, calculating engagement metrics, and accessing trending content from the YouTube Data API.

YouTube MCP 서버

YouTube 데이터 API를 활용한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. AI 언어 모델이 표준화된 인터페이스를 통해 YouTube 콘텐츠와 상호 작용할 수 있도록 지원합니다.

주요 특징

비디오 정보

  • 자세한 비디오 정보(제목, 설명, 길이, 통계)를 검색합니다.
  • 키워드로 영상 검색
  • 특정 비디오를 기반으로 관련 비디오를 가져옵니다.
  • 비디오 참여 비율을 계산하고 분석합니다.

대본/캡션 관리

  • 다국어 지원으로 비디오 자막 검색
  • 필사본에 대한 언어 기본 설정 지정
  • 정확한 콘텐츠 참조를 위해 타임스탬프가 찍힌 캡션에 액세스하세요

채널 분석

  • 자세한 채널 통계(구독자, 조회수, 영상 수)를 확인하세요
  • 채널에서 가장 성과가 좋은 비디오를 가져오세요
  • 채널 성장 및 참여 지표 분석

추세 분석

  • 지역 및 카테고리별 인기 영상 보기
  • 여러 비디오의 성능 지표를 비교하세요
  • 특정 카테고리의 인기 콘텐츠를 찾아보세요

사용 가능한 도구

서버는 다음과 같은 MCP 도구를 제공합니다.

도구 이름설명필수 매개변수
getVideoDetails메타데이터, 통계, 콘텐츠 세부 정보를 포함한 여러 YouTube 비디오에 대한 자세한 정보를 얻으세요.videoIds (배열)
searchVideos쿼리 문자열을 기반으로 비디오 검색query , maxResults (선택 사항)
getTranscripts여러 비디오의 대본 검색videoIds (배열), lang (선택 사항)
getRelatedVideosYouTube 추천 알고리즘을 기반으로 특정 영상과 관련된 영상을 받아보세요videoId , maxResults (선택 사항)
getChannelStatistics구독자 수, 조회수, 비디오 수를 포함한 여러 채널에 대한 자세한 측정 항목을 검색합니다.channelIds (배열)
getChannelTopVideos특정 채널에서 가장 많이 본 비디오를 얻으세요channelId , maxResults (선택 사항)
getVideoEngagementRatio여러 동영상에 대한 참여 지표(조회수, 좋아요, 댓글, 참여 비율)를 계산합니다.videoIds (배열)
getTrendingVideos지역 및 카테고리별로 현재 인기 있는 영상을 받아보세요regionCode (선택 사항), categoryId (선택 사항), maxResults (선택 사항)
compareVideos여러 비디오의 통계를 비교하세요videoIds (배열)

설치

Smithery를 통한 자동 설치

Smithery 를 통해 Claude Desktop에 YouTube MCP 서버를 자동으로 설치합니다.

지엑스피1

수동 설치

# Install from npm npm install youtube-data-mcp-server # Or clone repository git clone https://github.com/icraft2170/youtube-data-mcp-server.git cd youtube-data-mcp-server npm install

환경 구성

다음 환경 변수를 설정하세요.

  • YOUTUBE_API_KEY : YouTube 데이터 API 키(필수)
  • YOUTUBE_TRANSCRIPT_LANG : 기본 자막 언어(선택 사항, 기본값: 'ko')

MCP 클라이언트 구성

Claude Desktop 구성 파일에 다음을 추가하세요.

{ "mcpServers": { "youtube": { "command": "npx", "args": ["-y", "youtube-data-mcp-server"], "env": { "YOUTUBE_API_KEY": "YOUR_API_KEY_HERE", "YOUTUBE_TRANSCRIPT_LANG": "ko" } } } }

YouTube API 설정

  1. Google Cloud Console에 접속하세요
  2. 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
  3. YouTube 데이터 API v3 활성화
  4. API 자격 증명(API 키) 생성
  5. 생성된 API 키를 환경 구성에 사용하세요.

개발

# Install dependencies npm install # Run in development mode npm run dev # Build npm run build

네트워크 구성

서버는 통신을 위해 다음 포트를 노출합니다.

  • HTTP: 3000
  • gRPC: 3001

시스템 요구 사항

  • Node.js 18.0.0 이상

보안 고려 사항

  • API 키를 항상 안전하게 보관하고 버전 제어 시스템에 커밋하지 마십시오.
  • 환경 변수 또는 구성 파일을 통해 API 키를 관리하세요.
  • 무단 사용을 방지하기 위해 API 키에 대한 사용 한도를 설정하세요.

특허

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

-
security - not tested
F
license - not found
-
quality - not tested

표준화된 인터페이스를 통해 AI 언어 모델이 YouTube 콘텐츠와 상호 작용할 수 있도록 하여 비디오 정보, 대본, 채널 분석 및 추세 분석을 검색하기 위한 도구를 제공합니다.

  1. Key Features
    1. Video Information
    2. Transcript/Caption Management
    3. Channel Analysis
    4. Trend Analysis
  2. Available Tools
    1. Installation
      1. Automatic Installation via Smithery
      2. Manual Installation
    2. Environment Configuration
      1. MCP Client Configuration
        1. YouTube API Setup
          1. Development
            1. Network Configuration
              1. System Requirements
                1. Security Considerations
                  1. License
                    ID: alxyqqw9qw