YouTube MCP 서버
YouTube용 MCP(모델 컨텍스트 프로토콜) 서버 구현으로, AI 언어 모델이 표준화된 인터페이스를 통해 YouTube 콘텐츠와 상호 작용할 수 있습니다.
특징
비디오 정보
비디오 세부 정보(제목, 설명, 길이 등)를 받으세요.
채널 비디오 목록
비디오 통계(조회수, 좋아요, 댓글)를 얻으세요
YouTube에서 동영상 검색
성적증명서 관리
비디오 대본 검색
여러 언어 지원
타임스탬프가 찍힌 캡션을 받으세요
대본 내 검색
채널 관리
채널 세부 정보 가져오기
채널 재생목록 나열
채널 통계 가져오기
채널 콘텐츠 내 검색
재생목록 관리
재생 목록 항목 나열
재생 목록 세부 정보 가져오기
재생 목록 내에서 검색
재생목록 비디오 대본 받기
Related MCP server: YouTube Translate MCP
설치
Smithery를 통해 설치
Smithery 를 통해 Claude Desktop에 YouTube MCP 서버를 자동으로 설치하는 방법:
지엑스피1
수동 설치
npm install zubeid-youtube-mcp-server구성
다음 환경 변수를 설정하세요.
YOUTUBE_API_KEY: YouTube 데이터 API 키YOUTUBE_TRANSCRIPT_LANG: 대본의 기본 언어(선택 사항, 기본값은 'en')
MCP 클라이언트와 함께 사용
MCP 클라이언트 구성(예: Claude Desktop)에 다음을 추가합니다.
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "<YOUR_API_KEY>"
}
}
}
}VS Code와 함께 사용
한 번의 클릭으로 설치하려면 아래 설치 버튼 중 하나를 클릭하세요.
수동 설치
수동 설치를 원하시면 먼저 이 섹션 상단의 설치 버튼을 확인하세요. 그렇지 않은 경우 다음 단계를 따르세요.
VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가합니다. Ctrl + Shift + P 를 누르고 Preferences: Open User Settings (JSON) 입력하면 됩니다.
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "YouTube API Key",
"password": true
}
],
"servers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "${input:apiKey}"
}
}
}
}
}선택적으로 작업 공간의 .vscode/mcp.json 이라는 파일에 추가할 수 있습니다.
{
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "YouTube API Key",
"password": true
}
],
"servers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "${input:apiKey}"
}
}
}
}YouTube API 설정
Google Cloud Console로 이동
새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
YouTube 데이터 API v3 활성화
API 자격 증명(API 키) 생성
구성을 위해 API 키를 복사하세요
예시
비디오 관리
// Get video details
const video = await youtube.videos.getVideo({
videoId: "video-id"
});
// Get video transcript
const transcript = await youtube.transcripts.getTranscript({
videoId: "video-id",
language: "en"
});
// Search videos
const searchResults = await youtube.videos.searchVideos({
query: "search term",
maxResults: 10
});채널 관리
// Get channel details
const channel = await youtube.channels.getChannel({
channelId: "channel-id"
});
// List channel videos
const videos = await youtube.channels.listVideos({
channelId: "channel-id",
maxResults: 50
});재생 목록 관리
// Get playlist items
const playlistItems = await youtube.playlists.getPlaylistItems({
playlistId: "playlist-id",
maxResults: 50
});
// Get playlist details
const playlist = await youtube.playlists.getPlaylist({
playlistId: "playlist-id"
});개발
# Install dependencies
npm install
# Run tests
npm test
# Build
npm run build
# Lint
npm run lint기여하다
이 저장소에 기여하는 방법에 대한 자세한 내용은 CONTRIBUTING.md를 참조하세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.