YouTube MCP 서버
YouTube용 MCP(모델 컨텍스트 프로토콜) 서버 구현으로, AI 언어 모델이 표준화된 인터페이스를 통해 YouTube 콘텐츠와 상호 작용할 수 있습니다.
특징
비디오 정보
- 비디오 세부 정보(제목, 설명, 길이 등)를 받으세요.
- 채널 비디오 목록
- 비디오 통계(조회수, 좋아요, 댓글)를 얻으세요
- YouTube에서 동영상 검색
성적증명서 관리
- 비디오 대본 검색
- 여러 언어 지원
- 타임스탬프가 찍힌 캡션을 받으세요
- 대본 내 검색
채널 관리
- 채널 세부 정보 가져오기
- 채널 재생목록 나열
- 채널 통계 가져오기
- 채널 콘텐츠 내 검색
재생목록 관리
- 재생 목록 항목 나열
- 재생 목록 세부 정보 가져오기
- 재생 목록 내에서 검색
- 재생목록 비디오 대본 받기
설치
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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.