Remote Cloudflare Youtube Transcript MCP Server

🚀 YouTube 簡化版轉錄 MCP 服務器

這是一個高性能、無服務器版本的 YouTube 字幕提取服務，藉助模型上下文協議（MCP），部署於 Cloudflare Workers 之上，能為用戶高效提取 YouTube 視頻字幕。

🚀 快速開始

此 MCP 服務器允許 AI 助手通過簡單的 API 提取 YouTube 視頻的字幕。實現結合了轉錄提取功能從kimtaeyoon83/mcp-server-youtube-transcript與遠程 MCP 服務器架構來自Cloudflare AI 演示。

✨ 主要特性

• 無服務器部署：在 Cloudflare 的全球邊緣網絡上運行，延遲極低
• YouTube URL 靈活性：支持多種 URL 格式和直接視頻 ID
• 語言選擇：以不同語言提取字幕（默認為英語）
• 邊緣優化：超快響應時間（通常 400 - 800 毫秒）
• 最小實現：不到 300 行代碼，便於維護
• SSE 傳輸：實現服務器發送事件用於流式連接

📦 安裝指南

使用 Claude 桌面

安裝步驟

1. 打開 Claude 桌面，轉到設置 > 開發者 > 編輯配置。
2. 更新你的配置文件：

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

3. 重啟 Claude 桌面。

本地開發

先決條件

• Node.js 18 或更高版本。
• Wrangler CLI（npm install -g wrangler）。

設置步驟

# 克隆倉庫
git clone https://github.com/yourusername/youtube-transcript-mcp-server.git
cd youtube-transcript-mcp-server

# 安裝依賴項
npm install

# 本地運行
wrangler dev

部署到 Cloudflare

# 部署到 Cloudflare Workers
wrangler deploy

💻 使用示例

示例提示

你能展示這個 YouTube 視頻的字幕嗎？ https://www.youtube.com/watch?v=dQw4w9WgXcQ

提取此 TED 演講的字幕並總結關鍵點：https://youtu.be/8S0FDjFBj8o

使用 MCP 檢查器測試

1. 安裝 MCP 檢查器：

npx @modelcontextprotocol/inspector

2. 在檢查器中：
   • 設置傳輸類型為 SSE。
   • 輸入 http://localhost:8787/sse 作為 URL。
   • 點擊“連接”。
3. 使用 get_transcript 工具嘗試不同的 YouTube URL。

📚 詳細文檔

可用工具

🔧 技術細節

服務器由簡潔高效的代碼庫構建：

• YouTubeTranscriptMCPSqlite：核心 MCP 代理實現，具有轉錄提取功能。
• McpServer：處理 MCP 協議交互。
• MCP 協議集成：完整的 MCP 協議實現。

關鍵優化：

1. 高效的 URL 解析和驗證。
2. 最小外部依賴項。
3. 正確的錯誤處理，帶詳細錯誤消息。
4. 通過 SSE 實現流式支持。

📄 許可證

[在此處添加許可證信息，如果適用。]

信用

• 使用 @modelcontextprotocol/sdk 構建。
• 使用 youtube-captions-scraper 進行字幕提取。
• 受到以下項目啟發：
  • kimtaeyoon83/mcp-server-youtube-transcript
  • Cloudflare AI 演示