YouTube MCP 통합

이 프로젝트는 YouTube에 대한 MCP(모델 컨텍스트 프로토콜) 통합을 제공하여 LLM이 표준화된 도구를 통해 YouTube를 검색하고, 비디오 정보를 얻고, 대본을 검색할 수 있도록 합니다.

특징

YouTube 검색 도구 : 설정 가능한 결과 제한으로 YouTube에서 동영상 검색
비디오 정보 도구 : YouTube 비디오에 대한 자세한 정보를 얻으세요
대본 도구 : YouTube 비디오의 대본을 검색하고 구문 분석합니다.

건축학

구현은 LLM이 외부 도구 및 리소스와 상호 작용하는 방식을 표준화하는 모델 컨텍스트 프로토콜(MCP) 사양을 따릅니다. 아키텍처는 다음으로 구성됩니다.

MCP 서버 : HTTP/SSE 전송을 통해 YouTube 기능을 MCP 도구로 제공합니다.
YouTube API 통합 : YouTube 데이터를 스크래핑하여 검색, 비디오 정보 및 대본 기능을 제공합니다.
MCP 클라이언트 : MCP YouTube 도구를 사용하는 방법을 보여주는 클라이언트 예

시작하기

필수 조건

노드.js 18+
엔피엠

설치

지엑스피1

서버 실행

MCP 서버를 시작합니다.

npm run start

서버는 다음 엔드포인트를 사용하여 http://localhost:3000 에서 시작됩니다.

SSE 엔드포인트: /sse
메시지 엔드포인트: /messages

MCP 클라이언트와 함께 사용

MCP 도구는 모든 MCP 호환 클라이언트에서 사용할 수 있습니다. 도구 사용 방법의 예는 다음과 같습니다.

// Initialize client
const client = new Client(
  { name: 'youtube-client', version: '1.0.0' },
  { capabilities: { tools: {} } }
);

// Connect to the server
await client.connect(transport);

// Search YouTube
const searchResults = await client.callTool({
  name: 'youtube_search',
  arguments: {
    query: 'javascript tutorial',
    limit: 3
  }
});

// Get video info
const videoInfo = await client.callTool({
  name: 'youtube_get_video_info',
  arguments: {
    input: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
  }
});

// Get video transcript
const transcript = await client.callTool({
  name: 'youtube_get_transcript',
  arguments: {
    input: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
  }
});

사용 가능한 도구

`youtube_search`

YouTube 동영상을 검색하세요.

인수:

query (문자열, 필수): 검색 쿼리
limit (숫자, 선택 사항): 최대 결과 수(1-10, 기본값: 5)

응답: 제목, 비디오 ID, URL, 썸네일, 설명, 채널 정보, 조회수, 게시 날짜와 같은 세부 정보가 포함된 비디오 결과 목록입니다.

`youtube_get_video_info`

YouTube 동영상에 대한 자세한 정보를 얻으세요.

인수:

input (문자열, 필수): YouTube 비디오 ID 또는 URL

응답: 제목, 설명, 조회수, 게시 날짜, 채널 세부 정보, 썸네일 URL을 포함한 자세한 비디오 정보입니다.

`youtube_get_transcript`

YouTube 동영상의 대본을 받아보세요.

인수:

input (문자열, 필수): YouTube 비디오 ID 또는 URL

응답: 기본 비디오 정보와 함께 타임스탬프가 찍힌 비디오 대본이 제공됩니다.

특허

MIT

감사의 말

모델 컨텍스트 프로토콜

YouTube MCP Integration

Integrations