YouTube Toolbox
py-mcp-youtube-툴박스
YouTube와 상호작용할 수 있는 강력한 도구를 AI 어시스턴트에게 제공하는 MCP 서버로, 비디오 검색, 대본 추출, 댓글 검색 등이 포함됩니다.
개요
py-mcp-youtube-toolbox는 다음과 같은 YouTube 관련 기능을 제공합니다.
고급 필터링 옵션으로 YouTube 동영상 검색
비디오 및 채널에 대한 자세한 정보를 얻으세요
정렬 옵션을 사용하여 비디오 댓글 검색
여러 언어로 비디오 대본과 자막을 추출합니다.
주어진 비디오와 관련된 비디오를 찾으세요
지역별 인기 영상 보기
대본을 기반으로 비디오 콘텐츠 요약 생성
필터링, 검색 및 다중 비디오 기능을 갖춘 고급 대본 분석
Related MCP server: YouTube MCP Server
목차
필수 조건
Python : Python 3.12 이상 설치
YouTube API 키 :
Google Cloud Console 로 이동
새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
YouTube 데이터 API v3 활성화:
"API 및 서비스" > "라이브러리"로 이동하세요.
"YouTube Data API v3"를 검색하여 활성화하세요.
자격 증명을 만듭니다.
"API 및 서비스" > "자격 증명"으로 이동하세요.
"자격 증명 만들기" > "API 키"를 클릭하세요.
API 키를 적어 두세요
설치
Git 복제
지엑스피1
구성
UV 패키지 관리자를 설치하세요:
curl -LsSf https://astral.sh/uv/install.sh | sh가상 환경을 만들고 활성화하세요.
uv venv -p 3.12
source .venv/bin/activate # On MacOS/Linux
# or
.venv\Scripts\activate # On Windows종속성 설치:
uv pip install -r requirements.txt환경 변수:
cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_keyDocker 사용
Docker 이미지를 빌드합니다.
docker build -t py-mcp-youtube-toolbox .컨테이너를 실행합니다.
docker run -e YOUTUBE_API_KEY=your_youtube_api_key py-mcp-youtube-toolbox로컬 사용
서버를 실행합니다:
mcp run server.pyMCP 검사기를 실행합니다.
mcp dev server.pyMCP 설정 구성
MCP 설정 파일에 서버 구성을 추가합니다.
클로드 데스크톱 앱
Smithery를 통해 자동으로 설치하려면:
npx -y @smithery/cli install @jikime/py-mcp-youtube-toolbox --client claude수동으로 설치하려면
~/Library/Application Support/Claude/claude_desktop_config.json엽니다.
mcpServers 개체에 다음을 추가합니다.
{
"mcpServers": {
"YouTube Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-youtube-toolbox",
"run",
"server.py"
],
"env": {
"YOUTUBE_API_KEY": "your_youtube_api_key"
}
}
}
}커서 IDE
~/.cursor/mcp.json 엽니다
mcpServers 개체에 다음을 추가합니다.
{
"mcpServers": {
"YouTube Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-youtube-toolbox",
"run",
"server.py"
],
"env": {
"YOUTUBE_API_KEY": "your_youtube_api_key"
}
}
}
}도커를 위해
{
"mcpServers": {
"YouTube Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "YOUTUBE_API_KEY=your_youtube_api_key",
"py-mcp-youtube-toolbox"
]
}
}
}도구 문서
비디오 도구
search_videos: 고급 필터링 옵션(채널, 길이, 지역 등)을 사용하여 YouTube 동영상을 검색합니다.get_video_details: 특정 YouTube 동영상에 대한 자세한 정보(제목, 채널, 조회수, 좋아요 등)를 가져옵니다.get_video_comments: 정렬 옵션을 사용하여 YouTube 비디오에서 댓글 검색get_related_videos: 특정 YouTube 동영상과 관련된 동영상을 찾습니다.get_trending_videos: 지역별 YouTube 인기 영상 받기
채널 도구
get_channel_details: YouTube 채널에 대한 자세한 정보(이름, 구독자, 조회수 등)를 가져옵니다.
필사 도구
get_video_transcript: 지정된 언어로 된 YouTube 비디오에서 대본/캡션을 추출합니다.get_video_enhanced_transcript: 필터링, 검색 및 다중 비디오 기능을 갖춘 고급 대본 추출
프롬프트 도구
transcript_summary: 사용자 정의 옵션을 사용하여 대본을 기반으로 YouTube 비디오 콘텐츠 요약을 생성합니다.
리소스 도구
youtube://available-youtube-tools: 사용 가능한 모든 YouTube 도구 목록을 가져옵니다.youtube://video/{video_id}: 특정 비디오에 대한 자세한 정보를 가져옵니다.youtube://channel/{channel_id}: 특정 채널에 대한 정보를 가져옵니다.youtube://transcript/{video_id}?language={language}: 특정 비디오의 대본을 가져옵니다.
개발
로컬 테스트를 위해 포함된 클라이언트 스크립트를 사용할 수 있습니다.
# Example: Search videos
uv run client.py search_videos query="MCP" max_results=5
# Example: Get video details
uv run client.py get_video_details video_id=zRgAEIoZEVQ
# Example: Get channel details
uv run client.py get_channel_details channel_id=UCRpOIr-NJpK9S483ge20Pgw
# Example: Get video comments
uv run client.py get_video_comments video_id=zRgAEIoZEVQ max_results=10 order=time
# Example: Get video transcript
uv run client.py get_video_transcript video_id=zRgAEIoZEVQ language=ko
# Example: Get related videos
uv run client.py get_related_videos video_id=zRgAEIoZEVQ max_results=5
# Example: Get trending videos
uv run client.py get_trending_videos region_code=ko max_results=10
# Example: Advanced transcript extraction
uv run client.py get_video_enhanced_transcript video_ids=zRgAEIoZEVQ language=ko format=timestamped include_metadata=true start_time=100 end_time=200 query=에이전트 case_sensitive=true segment_method=equal segment_count=2
# Example: 특허
MIT 라이센스
Available Tools
8 toolsget_channel_detailsB
Get detailed information about a YouTube channel
Inputs: channel_id (required). Returns: result
get_trending_videosB
Get trending videos on YouTube by region
Inputs: region_code, max_results. Returns: result
get_video_commentsC
Get comments for a YouTube video
Inputs: video_id (required), max_results, order, include_replies, +1 more. Returns: result
get_video_detailsB
Get detailed information about a YouTube video
Inputs: video_id (required). Returns: result
get_video_enhanced_transcriptC
Advanced transcript extraction tool with filtering, search, and multi-video capabilities. Provides rich transcript data for detailed analysis and processing. Features: 1) Extract transcripts from multiple videos; 2) Filter by time ranges; 3) Search within transcripts; 4) Segment transcripts; 5) Format output in different ways; 6) Include video metadata.
Inputs: video_ids (required), language, start_time, end_time, +6 more. Returns: result
get_video_transcriptB
Get transcript/captions for a YouTube video
Inputs: video_id (required), language. Returns: result
search_videosC
Search for YouTube videos with advanced filtering options
Inputs: query (required), max_results, channel_id, order, +6 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools have distinct purposes, but there is notable overlap between get_video_transcript and get_video_enhanced_transcript, which could cause confusion as both handle transcripts with the enhanced version being a superset. Other tools like get_video_details and get_channel_details are clearly differentiated, but the transcript duplication weakens clarity.
All tool names follow a consistent snake_case pattern with a verb-noun structure (e.g., get_channel_details, search_videos). The naming is predictable and uniform across all eight tools, making it easy for agents to understand and use them without confusion.
With 8 tools, the count is well within the typical 3-15 range for a focused domain like YouTube data retrieval. It feels slightly thin for comprehensive coverage but reasonable for core functionalities such as fetching videos, channels, comments, and transcripts.
The toolset covers key read operations like getting details, searching, and fetching comments/transcripts, but lacks obvious write or management capabilities (e.g., upload, update, delete) that might be expected in a full YouTube toolbox. This creates notable gaps for agents needing to perform more than retrieval tasks.
Maintenance
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
An MCP server that gives any LLM or agent clean YouTube transcripts on demand: a single video, a whole channel, or a playlist, plus AI cleanup of auto-generated captions. API-key auth, credit-based, same backend as the public v1 API. Get a free API key with 25 free credits at youtubetranscriptdownload.com/account.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Fetch YouTube transcripts, monitor channels and track keyword matches from your AI assistant.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server for intelligent YouTube video analysis that provides token-optimized summaries, sentiment analysis, and entity extraction from transcripts. It enables AI assistants to perform video reporting, channel monitoring, and comprehensive YouTube searches through structured data tools.1053Apache 2.0
- AlicenseAqualityBmaintenanceMCP server that provides YouTube video data to AI agents, supporting search, metadata, comments, and transcripts without an API key.681 npmISC
- AlicenseAqualityDmaintenanceMCP server that lets AI agents search YouTube and fetch transcripts.23MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for YouTube that provides tools to fetch video metadata and transcripts, enabling natural language queries about YouTube videos.2-