Youtube Transcript MCP

🚀 YouTube轉錄MCP服務器

YouTube轉錄MCP服務器可獲取YouTube視頻的轉錄內容。它藉助MCP（Model Context Protocol）協議，讓Claude等AI模型能輕鬆利用YouTube視頻的字幕數據。

✨ 主要特性

• 從YouTube視頻URL中提取轉錄內容。
• 支持多語言轉錄，如韓語、英語等。
• 同時支持自動生成和手動生成的字幕。
• 可查詢可用的轉錄內容列表。

📦 安裝指南

1. 克隆倉庫

git clone <repository-url>
cd youtube_transcript_mcp

2. 創建並激活虛擬環境

python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# 或者在Windows系統下：venv\Scripts\activate

3. 安裝依賴項

pip install -r requirements.txt

📚 詳細文檔

Claude Desktop配置

若要在Claude Desktop中使用此MCP服務器，需修改Claude配置文件。

• macOS系統：Claude Desktop配置文件路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json。
• Windows系統：Claude Desktop配置文件路徑為 %APPDATA%\Claude\claude_desktop_config.json。

請在配置文件中添加以下內容：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "/path/to/your/youtube_transcript_mcp/venv/bin/python",
      "args": ["/path/to/your/youtube_transcript_mcp/youtube_transcript_mcp_server.py"],
      "env": {}
    }
  }
}

⚠️ 重要提示：請將 /path/to/your/youtube_transcript_mcp 替換為實際的項目路徑。

支持的URL格式

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• VIDEO_ID（僅11位視頻ID）

支持的語言

• 韓語 (ko) - 默認值
• 英語 (en)
• 其他YouTube支持的所有語言

若請求的語言不可用，服務器將按韓語 → 英語 → 自動生成字幕的順序嘗試獲取。

💻 使用示例

在Claude Desktop完成配置後，可按以下方式使用：

基礎用法

獲取轉錄內容

請獲取此YouTube視頻的轉錄內容：https://www.youtube.com/watch?v=VIDEO_ID

獲取特定語言的轉錄內容

請獲取此視頻的英語轉錄內容：https://www.youtube.com/watch?v=VIDEO_ID

查詢可用的轉錄內容列表

請顯示此視頻可用的轉錄內容列表：https://www.youtube.com/watch?v=VIDEO_ID

🔧 技術細節

API工具

此MCP服務器提供以下兩個工具：

1. get_youtube_transcript

• 說明：獲取YouTube視頻的轉錄內容。
• 參數：
  • url（必需）：YouTube視頻URL。
  • language（可選，默認值："ko"）：語言代碼。

2. list_available_transcripts

• 說明：獲取可用的轉錄內容列表。
• 參數：
  • url（必需）：YouTube視頻URL。

問題解決

配置未生效

1. 完全關閉並重新啟動Claude Desktop。
2. 確認配置文件路徑是否正確。
3. 確認虛擬環境是否已激活。

無法找到轉錄內容

• 該視頻可能沒有字幕。
• 視頻可能為私有視頻或訪問受限。
• 可使用 list_available_transcripts 工具查看可用語言。

依賴項

• mcp>=0.8.0：Model Context Protocol庫。
• youtube-transcript-api>=0.6.0：YouTube轉錄API。
• asyncio：異步處理。

📄 許可證

本項目遵循MIT許可證進行分發。