YouTube Transcript MCP Server

YouTube Transcript MCP サーバー

Cloudflare Workers にデプロイされた、Model Context Protocol（MCP）を使用する高性能なサーバーレス YouTube 文字起こし抽出サービスです。

概要

この MCP サーバーを使うと、AI アシスタントはシンプルな API を通じて YouTube 動画の文字起こしを取得できます。この実装では、kimtaeyoon83/mcp-server-youtube-transcript に見られる軽量な文字起こし抽出機能と、Cloudflare AI demos のリモート MCP サーバーアーキテクチャを組み合わせています。

機能

• サーバーレスデプロイ：Cloudflare のグローバルエッジネットワークで実行し、レイテンシーを最小限に抑えます
• YouTube URL の柔軟な指定：複数の URL 形式と動画 ID の直接指定に対応しています
• 言語選択：さまざまな言語で文字起こしを取得できます（デフォルトは英語です）
• エッジ最適化：非常に高速な応答時間（通常 400～800 ミリ秒）
• 最小限の実装：コードは 300 行未満で、メンテナンスが容易です
• SSE トランスポート：ストリーミング接続に Server-Sent Events を実装しています

利用可能なツール

ツール	説明	パラメーター
get_transcript	YouTube 動画の文字起こしを抽出します	url（必須）：YouTube 動画の URL または ID lang（任意、デフォルト："en"）：言語コード

Claude Desktop での使用方法

インストール

1. Claude Desktop を開き、Settings > Developer > Edit Config に移動します
2. 設定ファイルを更新します：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-deployed-worker.workers.dev/sse"
      ]
    }
  }
}

3. Claude Desktop を再起動します

プロンプトの例

Can you show me the transcript of this YouTube video? https://www.youtube.com/watch?v=dQw4w9WgXcQ

Extract the transcripts from this TED talk and summarize the key points: https://youtu.be/8S0FDjFBj8o

ローカル開発

前提条件

• Node.js 18 以降
• Wrangler CLI（npm install -g wrangler）

セットアップ

# Clone the repository
git clone https://github.com/yourusername/youtube-transcript-mcp-server.git
cd youtube-transcript-mcp-server

# Install dependencies
npm install

# Run locally
wrangler dev

MCP Inspector を使用したテスト

1. MCP Inspector をインストールします：

   npx @modelcontextprotocol/inspector
   

2. Inspector で次の操作を行います：

   • Transport Type を SSE に設定します
   • URL として http://localhost:8787/sse を入力します
   • "Connect" をクリックします

3. YouTube URL を変えて get_transcript ツールを試します

Cloudflare へのデプロイ

# Deploy to Cloudflare Workers
wrangler deploy

技術的な実装

このサーバーは、最小限かつ高効率なコードベースで構築されています。

• YouTubeTranscriptMCPSqlite：文字起こし抽出機能を備えた MCP エージェントのコア実装
• McpServer：MCP プロトコルとのやり取りを処理します
• MCP Protocol Integration：Model Context Protocol の完全な実装

主な最適化：

1. 効率的な URL の解析と検証
2. 外部依存関係の最小化
3. 詳細なエラーメッセージを含む適切なエラー処理
4. SSE によるストリーミング対応

クレジット

• @modelcontextprotocol/sdk を使用して構築
• 文字起こしの抽出に youtube-captions-scraper を使用
• 以下から着想を得ています：
  • kimtaeyoon83/mcp-server-youtube-transcript
  • Cloudflare AI Remote MCP Server demo

ライセンス

MIT