Skip to main content
Glama
Magiprr

claude-youtube-transcript

by Magiprr

🎬 claude-youtube-transcript

Python MCP License: MIT macOS Windows

Claude Desktop に YouTube の URL を貼り付けると、動画の完全なトランスクリプトを取得できます。

最小限の MCP サーバーは、Claude に get_transcript というツールを提供し、字幕のある任意の 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)

  • PATH 上の Python 3.10 以上

  • それだけ: 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

-ExecutionPolicy Bypass が必要なのは、Windows が既定で署名のないスクリプトをブロックするためです。これはその実行にのみ適用され、システム全体のポリシーを変更しません。

インストーラー(両 OS とも):

  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)で取得できます。

ファイルの場所は OS によって異なります:

OS

パス

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 では ✕ を閉じるだけでは不十分で、システムトレイのアイコンを右クリックして 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 に組み込まれているエイリアススタブが原因です。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