YouTube MCP 서버

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

주요 특징

비디오 정보

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

대본/캡션 관리

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

채널 분석

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

추세 분석

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

사용 가능한 도구

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

도구 이름	설명	필수 매개변수
`getVideoDetails`	메타데이터, 통계, 콘텐츠 세부 정보를 포함한 여러 YouTube 비디오에 대한 자세한 정보를 얻으세요.	`videoIds` (배열)
`searchVideos`	쿼리 문자열을 기반으로 비디오 검색	`query` , `maxResults` (선택 사항)
`getTranscripts`	여러 비디오의 대본 검색	`videoIds` (배열), `lang` (선택 사항)
`getRelatedVideos`	YouTube 추천 알고리즘을 기반으로 특정 영상과 관련된 영상을 받아보세요	`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 설정

Google Cloud Console에 접속하세요
새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
YouTube 데이터 API v3 활성화
API 자격 증명(API 키) 생성
생성된 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 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

This server cannot be installed

security - not tested

license - not found

quality - not tested

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.

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

Related MCP Servers

YouTube MCP Server
ZubeidHendricks
A
security
F
license
A
quality
This server allows AI language models to interact with YouTube content through a standardized interface, providing features such as video and channel information retrieval, transcript management, and playlist operations.
Last updated -
7
182
205
TypeScript
Youtube-Summarizer MCP Server
trilogy-group
-
security
F
license
-
quality
Enables AI applications to integrate with YouTube-Summarizer's APIs through the MCP protocol, offering local tool-based interaction for summarizing YouTube content.
Last updated -
1
Python
Youtube MCP Server
sparfenyuk
A
security
A
license
A
quality
Bridges YouTube API and AI assistants, enabling video analysis by downloading and processing closed captions to create summaries of YouTube videos.
Last updated -
1
3
Python
MIT License
YouTube Transcript Extractor MCP
MalikElate
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to extract transcripts from YouTube videos, allowing AI to analyze and work with video content directly.
Last updated -
6
1
TypeScript

View all related MCP servers

YouTube MCP Server