Skip to main content
Glama
Magiprr

claude-youtube-transcript

by Magiprr

🎬 claude-youtube-transcript

Python MCP License: MIT macOS Windows

Claude Desktop에 YouTube URL을 붙여넣으면 해당 동영상의 전체 자막을 받아볼 수 있습니다.

get_transcript 도구를 Claude에게 제공하는 최소 MCP 서버입니다. 자막이 있는 YouTube 동영상이라면 어떤 것이든 자막을 읽어 줍니다. API 키도, Google 계정도, 동영상 다운로드도 필요 없습니다. 텍스트 트랙 하나만 연속된 블록으로 반환하므로 모델이 요약, 번역, 인용하기에 바로 사용할 수 있습니다.


✨ 기능

  • 모든 URL 형식 지원watch?v=, youtu.be/, /shorts/, /embed/, /live/, 또는 11자리 원시 동영상 ID.

  • 스페인어 우선, 영어로 폴백, 사람이 만든 자막이 없으면 자동 생성 자막을 사용합니다.

  • youtube-transcript-api 0.6 및 1.x와 호환 — 클래식 API, 인스턴스 방식, 자막 트랙 목록을 순서대로 시도합니다.

  • 연속된 일반 텍스트 반환 — 타임스탬프나 [Música] 마크가 없어 추가 컨텍스트를 낭비하지 않습니다.

Related MCP server: YouTube Transcript MCP Server

📋 요구 사항

  • Claude Desktop (macOS, Windows 또는 Linux).

  • Python 3.10 이상이 PATH에 있어야 합니다.

  • 그 외에는 없습니다: API 키, Google 계정, ffmpeg가 필요 없습니다.

🚀 빠른 설치

macOS / Linux

git clone https://github.com/Magiprr/claude-youtube-transcript.git && cd claude-youtube-transcript && ./install.sh

Windows

PowerShell에서:

git clone https://github.com/Magiprr/claude-youtube-transcript.git; cd claude-youtube-transcript; powershell -ExecutionPolicy Bypass -File .\install.ps1

Windows는 기본적으로 서명되지 않은 스크립트를 차단하므로 -ExecutionPolicy Bypass가 필요합니다. 해당 실행에만 적용되는 유일한 항목이므로 시스템 정책을 변경하지 않습니다.

설치 프로그램(두 시스템 모두)은:

  1. 📦 pip --break-system-packages로 의존성을 설치합니다.

  2. 🔍 server.pypython3 바이너리의 절대 경로를 찾습니다.

  3. 💾 claude_desktop_config.json을 건드리기 전에 백업합니다.

  4. 🤝 이미 있는 MCP 서버를 덮어쓰지 않고 youtube-transcript 블록을 병합합니다.

  5. 🔄 Claude Desktop을 다시 시작하라고 안내합니다 (창을 닫는 것만으로 안 됩니다. Cmd + Q 입니다).

수동 설치

직접 설정하려면 다음 내용을 ~/Library/Application Support/Claude/claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "/opt/homebrew/bin/python3",
      "args": ["/ruta/absoluta/a/claude-youtube-transcript/server.py"]
    }
  }
}

두 경로 모두 절대 경로여야 합니다. Python 경로는 which python3(Windows에서는 where python)로 확인할 수 있습니다.

파일 위치는 운영체제에 따라 다릅니다:

운영체제

경로

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

Windows에서는 JSON 안의 경로에 이중 백슬래시(C:\\Users\\tu-usuario\\...)나 일반 슬래시를 사용합니다. 설치 프로그램은 자동으로 올바르게 작성합니다.

🔎 Claude가 받는 내용

이 도구는 타임스탬프나 사운드 마크 없이 평범한 블록을 반환합니다:

Transcripcion de https://www.youtube.com/watch?v=VIDEO_ID

Hoy vamos a ver como funciona el protocolo MCP y por que cambia la forma
en que las aplicaciones le dan herramientas a un modelo de lenguaje...

이렇게 하면 모델은 메타데이터가 아닌 콘텐츠에 컨텍스트를 사용합니다.

💬 프롬프트 예시

Claude Desktop을 다시 시작하고 나서:

Resúmeme este video en 10 bullets: https://www.youtube.com/watch?v=dQw4w9WgXcQ
Extrae de este video todas las cifras que menciona, con el contexto de cada una:
https://youtu.be/dQw4w9WgXcQ
Traduce al español la transcripción de https://www.youtube.com/shorts/dQw4w9WgXcQ
Compara qué dicen estos dos videos sobre el mismo tema:
<url 1>
<url 2>
De este video, dame solo las partes donde habla de precios, citadas textual:
<url>

🩺 문제 해결

앱을 완전히 종료한 후 다시 실행하세요. macOS에서는 Cmd + Q입니다. Windows에서는 X 버튼만으로 부족합니다. 시스템 트레이 아이콘을 마우스 오른쪽 버튼으로 클릭하고 Quit를 선택해야 합니다. 두 경우 모두 창을 닫는 것은 프로세스를 종료하지 않습니다. 그다음 블록이 잘 작성되었는지 확인하세요:

python3 -m json.tool ~/Library/Application\ Support/Claude/claude_desktop_config.json

Homebrew Python이 스스로 보호하고 있는 것입니다. 설치 프로그램은 이미 --break-system-packages를 사용합니다. 수동으로 실행한다면:

python3 -m pip install -r requirements.txt --break-system-packages

시스템 Python을 건드리고 싶지 않다면 venv를 사용하고 config의 command/ruta/al/venv/bin/python으로 지정하세요.

Claude Desktop이 의존성을 설치한 Python이 아닌 다른 Python을 사용하고 있습니다. config에 어떤 Python이 남아 있는지 확인하고, 동일한 Python에 패키지가 설치되어 있는지 확인하세요:

/opt/homebrew/bin/python3 -c "import mcp, youtube_transcript_api; print('ok')"

모든 동영상에 자막이 있는 것은 아닙니다. 저자가 자막을 비활성화했거나, 동영상이 비공개이거나 연령 제한이 있거나, 진행 중인 라이브 방송일 수 있습니다. YouTube에서 CC 버튼이 있는지 확인하세요.

YouTube는 IP별로 요청을 제한합니다. 공유 네트워크나 VPN에서 자주 발생합니다. 몇 분 기다렸다 다시 시도하거나, 다른 연결을 사용해 보세요.

PowerShell 실행 정책 때문입니다. 이렇게 실행하세요:

powershell -ExecutionPolicy Bypass -File .\install.ps1

Windows에서 그 파일을 인터넷에서 다운로드한 파일로 표시한 경우:

Unblock-File .\install.ps1

Windows에 기본 내장된 스텁 별칭(stub alias)이기 때문입니다. python.org에서 실제 Python을 설치하며 **"Add python.exe to PATH"**를 체크하세요. 설치 프로그램은 인터프리터를 찾을 때 이 스텁을 이미 무시합니다.

# macOS
tail -f ~/Library/Logs/Claude/mcp-server-youtube-transcript.log
# Windows
Get-Content -Wait "$env:APPDATA\Claude\Logs\mcp-server-youtube-transcript.log"

🛠️ 개발

서버를 직접 실행해서 잘 올라오는지 확인할 수 있습니다:

python3 server.py

stdio로 대기합니다 (Claude Desktop이 이 방식으로 통신합니다). 따라서 아무것도 출력하지 않으면 정상입니다.

기록 라이선스

MIT © 2026

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Magiprr/claude-youtube-transcript'

If you have feedback or need assistance with the MCP directory API, please join our Discord server