Skip to main content
Glama
youtube-mcp

youtube-mcp

by gimslab

YouTube MCP Server

Claude, Antigravity 등 AI 도구에서 YouTube 콘텐츠에 접근할 수 있는 MCP(Model Context Protocol) 서버입니다.

기능

도구

설명

API 키 필요

get_transcript

자막/트랜스크립트 추출

❌

get_video_info

영상 메타데이터 조회

✅

get_channel_info

채널 정보 조회

✅

search_videos

YouTube 검색

✅

Related MCP server: mcp-server-youtube

설치

cd youtube-mcp
npm install
npm run build

환경 변수

모든 기능을 사용하려면 YouTube Data API v3 키가 필요합니다:

export YOUTUBE_API_KEY="your-api-key-here"

API 키가 없으면 get_transcript 기능만 사용 가능합니다.

Claude Desktop 연동

~/.config/claude/claude_desktop_config.json 파일에 추가:

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["/home/gim/projects/youtube-mcp/build/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Antigravity 연동

MCP 서버 설정에서 다음과 같이 추가:

{
  "youtube-transcript": {
    "command": "node",
    "args": ["/home/gim/projects/youtube-mcp/build/index.js"],
    "env": {
      "YOUTUBE_API_KEY": "your-api-key-here"
    }
  }
}

사용 예시

자막 추출

get_transcript("https://youtube.com/watch?v=VIDEO_ID", "ko")

영상 정보 조회

get_video_info("https://youtube.com/watch?v=VIDEO_ID")

채널 정보 조회

get_channel_info("UCxxxxxx")

YouTube 검색

search_videos("검색어", 10)

라이선스

MIT

Available Tools

4 tools
get_channel_infoA

Get information about a YouTube channel including subscriber count, video count, and recent uploads.

Inputs: channelId (required).

get_transcriptA

Extract transcript/subtitles from a YouTube video. Works without API key.

Inputs: url (required), lang.

get_video_infoA

Get metadata for a YouTube video including title, description, view count, likes, and more.

Inputs: url (required).

search_videosA

Search for YouTube videos by keyword.

Inputs: query (required), maxResults.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct resource: transcript, video metadata, channel info, and search results. There is no overlap or ambiguity between them.

    Naming Consistency4/5

    Most tools follow the get_<resource> pattern (get_transcript, get_video_info, get_channel_info), with search_videos as a minor deviation. The naming is still clear and predictable, but not perfectly uniform.

    Tool Count5/5

    The server has 4 tools, which is well-scoped for a YouTube info retrieval MCP. Each tool serves a clear and necessary purpose without redundancy.

    Completeness4/5

    The coverage is solid for a read-only YouTube API: search, video info, channel info, and transcripts. Minor gaps like playlist support or comments are not core to the apparent purpose, so agents can work around them.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers