Wiki: ページの作成:「== 概要 == YouTube MCPサーバは、Model Context Protocol (MCP) を通じて、AIアシスタントがYouTube動画の字幕・トランスクリプトを取得するための機能を提供するサーバである。
YouTube動画のURLを指定するだけで、AIアシスタントが動画の内容を分析・要約できるようになる。

YouTube Data APIキーは不要で、手軽に導入可能である。
Claude Desktop、Claude Code…」

2026-03-25T08:45:58Z

ページの作成:「== 概要 == YouTube MCPサーバは、Model Context Protocol (MCP) を通じて、AIアシスタントがYouTube動画の字幕・トランスクリプトを取得するための機能を提供するサーバである。 YouTube動画のURLを指定するだけで、AIアシスタントが動画の内容を分析・要約できるようになる。 YouTube Data APIキーは不要で、手軽に導入可能である。 Claude Desktop、Claude Code…」

新規ページ

== 概要 ==
YouTube MCPサーバは、Model Context Protocol (MCP) を通じて、AIアシスタントがYouTube動画の字幕・トランスクリプトを取得するための機能を提供するサーバである。 
YouTube動画のURLを指定するだけで、AIアシスタントが動画の内容を分析・要約できるようになる。 
 
YouTube Data APIキーは不要で、手軽に導入可能である。 
Claude Desktop、Claude Code、VS Code等の主要なMCPクライアントに対応し、Windows、MacOS、Linuxの主要なOSで動作する。 
 
代表的な実装として以下の2つが存在する。 
 
<center>
{| class="wikitable"
|+ YouTube文字起こしMCPサーバー実装比較
|-
! 実装名 !! 説明
|-
| mcp-youtube (@anaisbetts/mcp-youtube) || Ani Betts氏が開発した実装であり、yt-dlpを使用して字幕を取得する。 単純な構成で導入が容易であり、YouTube Data APIキーは不要である。
|-
| mcp-server-youtube-transcript (@kimtaeyoon83/mcp-server-youtube-transcript) || Kim Taeyoon氏が開発した実装であり、 多言語対応、広告フィルタリング、タイムスタンプ制御等の高度な機能を提供する。 外部ツールへの依存がなく、Node.jsのみで動作する。
|}
</center>
 
主な活用シーンを以下に示す。 
* 動画コンテンツの要約と分析
* 技術動画から情報抽出
* ポッドキャスト形式コンテンツの分析
* 言語学習における多言語字幕の取得
 

== 2つのサーバの比較 ==
下表に、mcp-youtubeとmcp-server-youtube-transcriptの主要な違いを示す。 
 
<center>
{| class="wikitable"
|+ YouTube MCPサーバ比較
! 項目 !! mcp-youtube !! mcp-server-youtube-transcript
|-
| 開発元 || Ani Betts || Kim Taeyoon
|-
| npmパッケージ || @anaisbetts/mcp-youtube || @kimtaeyoon83/mcp-server-youtube-transcript
|-
| バージョン || 0.6.0 || 0.1.1
|-
| ライセンス || MIT || MIT
|-
| GitHub スター数 || 506 || 503
|-
| 外部依存 || yt-dlp 必須 || なし
|-
| 多言語対応 || 限定的 || 対応 (自動フォールバック)
|-
| 広告フィルタリング || なし || 対応 (デフォルト有効)
|-
| タイムスタンプ制御 || タイムスタンプ除去 || 表示 / 非表示を選択可能
|-
| YouTube Shorts対応 || 不明 || 対応
|-
| YouTube API キー || 不要 || 不要
|}
</center>
 

== 動作要件 ==
==== mcp-youtubeの要件 ====
* Node.js
*: MCPサーバの実行環境として必要
* yt-dlp
*: 字幕取得のために必要な外部ツール
*: MacOS: <code>brew install yt-dlp</code>
*: Python環境: <code>pip install yt-dlp</code>
*: Windows (WinGet): <code>winget install yt-dlp</code>
 
==== mcp-server-youtube-transcriptの要件 ====
* Node.js 18以上
*: MCPサーバの実行環境として必要
*: 外部ツールへの依存はなし
 

== インストール ==
==== yt-dlpのインストール (mcp-youtubeを使用する場合) ====
mcp-youtubeはyt-dlpに依存するため、事前にインストールが必要である。 
 
===== MacOSの場合 =====
Homebrewを使用する場合は、以下に示すコマンドを実行する。 
 
brew install yt-dlp
 
===== Linux / MacOSの場合 (pip経由) =====
pipを使用する場合は、以下に示すコマンドを実行する。 
 
pip install yt-dlp
 
===== Windowsの場合 =====
WinGetを使用する場合は、以下に示すコマンドを実行する。 
 
winget install yt-dlp
 
インストール後、yt-dlpコマンドがPATHに含まれていることを確認する。 
 
yt-dlp --version
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は、以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
==== mcp-youtubeの設定 ====
===== Claude Desktopでの設定 =====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "@anaisbetts/mcp-youtube"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
===== Claude Codeでの設定 =====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してMCPサーバを追加できる。 
 
claude mcp add youtube -- npx -y @anaisbetts/mcp-youtube
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
 
claude mcp add --scope project youtube -- npx -y @anaisbetts/mcp-youtube
 
===== VS Code / Cursorでの設定 =====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "@anaisbetts/mcp-youtube"]
}
}
}
</syntaxhighlight>
 
===== Windowsでの設定 =====
Windowsでは <code>npx</code> を使用するMCPサーバの場合、<code>cmd /c</code> ラッパーが必要である。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@anaisbetts/mcp-youtube"]
}
}
}
</syntaxhighlight>
 
==== mcp-server-youtube-transcriptの設定 ====
===== Claude Desktopでの設定 =====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
===== Claude Codeでの設定 =====
claude mcp add youtube-transcript -- npx -y @kimtaeyoon83/mcp-server-youtube-transcript
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
 
claude mcp add --scope project youtube-transcript -- npx -y @kimtaeyoon83/mcp-server-youtube-transcript
 
===== VS Code / Cursorでの設定 =====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
}
}
}
</syntaxhighlight>
 
===== Windowsでの設定 =====
Windowsでは <code>cmd /c</code> ラッパーを使用する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube-transcript": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
}
}
}
</syntaxhighlight>
 

== ツール仕様 ==
==== mcp-youtubeのツール ====
下表に、mcp-youtubeが提供するツールを示す。 
 
<center>
{| class="wikitable"
|+ mcp-youtube ツール一覧
! ツール名 !! 説明
|-
| get_transcript || YouTube URLを指定して字幕テキストを取得する。 yt-dlpを使用して字幕データを取得し、テキスト形式で返す。
|}
</center>
 
==== mcp-server-youtube-transcriptのツール ====
下表に、mcp-server-youtube-transcriptが提供するツールとパラメータを示す。 
 
<center>
{| class="wikitable"
|+ mcp-server-youtube-transcript ツール一覧
! ツール名 !! パラメータ !! 説明
|-
| get_transcript || url (必須) || YouTube動画URL、Shorts URL、動画IDを指定する。
|-
| get_transcript || lang (オプション、デフォルト: "en") || 取得する字幕の言語コードを指定する。 例: ja (日本語)、en (英語)、ko (韓国語)
|-
| get_transcript || include_timestamps (オプション、デフォルト: false) || タイムスタンプを字幕テキストに含めるかどうかを指定する。
|-
| get_transcript || strip_ads (オプション、デフォルト: true) || 広告・スポンサーシップに関する文字列を除去するかどうかを指定する。
|}
</center>
 
==== 対応URL形式 (mcp-server-youtube-transcript) ====
mcp-server-youtube-transcriptは、以下に示すURL形式に対応している。 
 
* 通常URL
*: https://www.youtube.com/watch?v=<動画ID>
* YouTube Shorts URL
*: https://www.youtube.com/shorts/<動画ID>
* 短縮URL
*: https://youtu.be/<動画ID>
* 動画IDのみ
*: <動画ID>
 

== 使用方法 ==
MCPサーバを設定後、AIアシスタントに自然言語で指示するだけで、対応するツールが自動的に呼び出される。 
 
==== 動画の要約 ====
YouTube動画の内容を要約する場合の操作例を以下に示す。 
 
* 動画全体を要約する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

このYouTube動画を要約してください: https://www.youtube.com/watch?v=xxxxx
</syntaxhighlight>
*: 
* キーポイントを抽出する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

この動画のキーポイントを5つ教えてください: https://www.youtube.com/watch?v=xxxxx
</syntaxhighlight>
*: 
 
==== 多言語字幕の取得 ====
特定の言語で字幕を取得する場合の操作例を以下に示す。 
mcp-server-youtube-transcriptを使用する場合に有効である。 
 
* 日本語字幕を取得する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

この動画の日本語字幕を取得してください: https://www.youtube.com/watch?v=xxxxx
</syntaxhighlight>
*: 
 
==== 技術情報の抽出 ====
技術動画から特定の情報を抽出する場合の操作例を以下に示す。 
 
* 動画で紹介されているツールを一覧化する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

この技術動画で紹介されているツールを一覧にしてください: https://www.youtube.com/watch?v=xxxxx
</syntaxhighlight>
*: 
 

== トラブルシューティング ==
下表に、一般的なエラーと対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 原因 !! 対処法
|-
| yt-dlpが見つからない (mcp-youtube) || yt-dlpがインストールされていない。 または、PATHに含まれていない。 || yt-dlpをインストールして、PATHに追加する。 <code>yt-dlp --version</code> コマンドで動作確認する。
|-
| 字幕が取得できない || 動画に字幕が存在しない。 または、字幕が無効化されている。 || 字幕が存在する動画を指定する。 動画のYouTubeページで字幕の有無を確認する。
|-
| 指定した言語の字幕が取得できない || 指定した言語コードの字幕が動画に存在しない。 || 別の言語コードを試す。 mcp-server-youtube-transcriptは自動フォールバックを試みるが、 全言語で字幕がない場合はエラーとなる。
|-
| npxコマンドエラーが発生する (Windows) || Windowsでは <code>npx</code> を直接実行できない場合がある。 || 設定ファイルで <code>cmd /c</code> ラッパーを使用する。
|-
| Node.jsバージョンエラーが発生する || インストールされているNode.jsが要件を満たしていない。 || mcp-server-youtube-transcriptの場合、 Node.js v18以降にアップグレードする。
|-
| MCPサーバが起動しない || 設定ファイルの記述に誤りがある。 または、Node.jsがインストールされていない。 || MCPクライアントを再起動する。 設定ファイルのJSON構文を確認する。 Node.jsのインストール状態を確認する。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,YouTube,MCP,Model Context Protocol,字幕,トランスクリプト,Claude,AI,mcp-youtube,yt-dlp,mcp-server-youtube-transcript,MCPサーバ,AIアシスタント
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - YouTube - 版の履歴