YouTube MCP 서버

YouTube 동영상과 상호작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 동영상 메타데이터와 자막을 추출하고 다양한 템플릿을 사용하여 마크다운 형식으로 변환하는 도구를 제공합니다.

특징

비디오 메타데이터 : 포괄적인 비디오 정보 가져오기
캡션 추출 : 자동 생성 및 수동 캡션 지원
여러 언어 : 영어와 프랑스어에 대한 기본 지원
템플릿 시스템 : 3가지 기본 제공 마크다운 템플릿:
- 기본: 간단한 대본 형식
- 세부 정보: 타임스탬프가 포함된 전체 메타데이터
- 검색: 컨텍스트를 사용하여 강조 표시된 결과
검색 기능 : 비디오 자막 내에서 검색
유연한 인증 : API 키와 OAuth2 인증을 모두 지원합니다.

필수 조건

Node.js(v16 이상)
npm 또는 yarn
YouTube 데이터 API 키 및/또는 OAuth2 자격 증명

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

구성

YouTube 자격 증명을 사용하여 루트 디렉토리에 .env 파일을 만듭니다.

YOUTUBE_API_KEY=your_api_key
YOUTUBE_CLIENT_ID=your_client_id
YOUTUBE_CLIENT_SECRET=your_client_secret
YOUTUBE_REFRESH_TOKEN=your_refresh_token  # Optional, for OAuth2

MCP 구성

MCP 설정 파일(일반적으로 ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json )에 서버를 추가합니다.

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["path/to/youtube-mcp/build/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your_api_key",
        "YOUTUBE_CLIENT_ID": "your_client_id",
        "YOUTUBE_CLIENT_SECRET": "your_client_secret"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

용법

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

1. 비디오 정보 얻기

use_mcp_tool youtube get_video_info {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID"
}

2. 캡션 받기

use_mcp_tool youtube get_captions {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "language": "en"  // Optional, defaults to "en"
}

3. 마크다운으로 변환

use_mcp_tool youtube convert_to_markdown {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "template_name": "detailed",  // Optional, "basic", "detailed", or "search"
  "language": "en",            // Optional
  "options": {                 // Optional
    "include_chapters": true,
    "search_term": "keyword"   // Only for search template
  }
}

4. 목록 템플릿

use_mcp_tool youtube list_templates

종속성

{
  "dependencies": {
    "@modelcontextprotocol/sdk": "latest",
    "googleapis": "^146.0.0",
    "google-auth-library": "^9.0.0",
    "youtube-captions-scraper": "^2.0.0",
    "express": "^4.18.2",
    "open": "^9.1.0"
  },
  "devDependencies": {
    "@types/node": "^20.0.0",
    "typescript": "^5.0.0",
    "tsx": "^4.0.0"
  }
}

OAuth2 설정

OAuth2 인증(비공개 비디오 액세스에 필요):

Google Cloud Console 에서 프로젝트 만들기
YouTube 데이터 API v3 활성화
OAuth2 자격 증명 생성(웹 애플리케이션 유형)
인증 스크립트를 실행합니다.

node src/get-api-key.js

브라우저의 지시에 따라 애플리케이션을 승인하세요.
구성에 새로 고침 토큰을 복사하세요

템플릿 사용자 정의

src/index.ts 의 DEFAULT_TEMPLATES 배열을 수정하여 사용자 정의 템플릿을 추가할 수 있습니다. 템플릿은 다음 구조를 따릅니다.

interface MarkdownTemplate {
  name: string;
  description: string;
  format: {
    header?: string;
    chapter_format?: string;
    caption_block: string;
    timestamp_format?: string;
    search_result_format?: string;
  }
}

특허

MIT

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

다양한 템플릿을 사용하여 메타데이터와 여러 언어의 자막을 추출하고 콘텐츠를 마크다운으로 변환하여 YouTube 비디오와의 상호작용을 가능하게 합니다.

Appeared in Searches

Tools or methods to search and analyze YouTube videos