MCP Video Digest

🚀 MCP 視頻轉錄工具

MCP 視頻轉錄工具是一款強大的視頻處理軟件，它支持從 YouTube 等平臺下載視頻，並能將視頻中的音頻精準轉換為文字。藉助多種先進語音識別技術，用戶可快速完成視頻轉錄任務。

🚀 快速開始

MCP 視頻轉錄工具能讓你輕鬆從主流視頻平臺下載視頻，並將其音頻轉換為文字。以下是使用該工具的基本步驟：

1. 克隆項目倉庫並安裝依賴項。
2. 配置環境變量和服務優先級。
3. 啟動服務並進行客戶端調用。

✨ 主要特性

• 多平臺兼容：支持 YouTube、Vimeo 等主流視頻平臺。
• 高效下載：內置強大下載器，可處理各種視頻格式。
• 精準轉錄：整合 Deepgram、Gladia、AssemblyAI 和 Speechmatics 等知名語音識別服務。
• 靈活配置：支持自定義 API 密鑰和參數設置。
• 智能錯誤處理：自動檢測並修復下載和轉錄過程中出現的問題。

📦 安裝指南

安裝步驟

1. 克隆項目倉庫：

git clone https://github.com/your-username/MCP-Video.git
cd MCP-Video

2. 安裝依賴項：

uv pip install -r requirements.txt

📚 詳細文檔

配置說明

環境變量配置

請在項目根目錄下創建 config.env 文件，並填寫以下內容：

DEEPGRAM_API_KEY=your_key_here
GLADIA_API_KEY=your_key_here
ASSEMBLYAI_API_KEY=your_key_here
SPEECHMATICS_API_KEY=your_key_here

服務優先級設置

# config.py
SERVICE_PRIORITY = [
    'Deepgram',
    'Gladia',
    'AssemblyAI',
    'Speechmatics'
]

使用說明

啟動服務

uv run main.py

客戶端調用示例

from mcp_video import MCPVideoProcessor

processor = MCPVideoProcessor()
# 下載視頻
video_path = processor.download_video('https://www.youtube.com/watch?v=12345')
# 提取音頻
audio_path = processor.extract_audio(video_path)
# 轉錄音頻
transcript = processor.transcribe(audio_path)
print(transcript.text)

測試說明

測試運行

uv test

開發指南

新服務添加

在 src/services/transcription/ 目錄下創建新類，繼承自 BaseTranscriptionService 並實現 transcribe 方法。

自定義下載器開發

在 src/services/download/ 目錄下擴展或修改現有下載器，建議參考 YouTubeDownloader 類。

依賴管理

• 使用 uv pip install package_name 安裝新依賴。
• 使用 uv pip freeze > requirements.txt 導出當前依賴。

錯誤處理

服務內置了完善的錯誤處理機制，能夠自動處理以下問題：

• API 請求失敗
• 網絡連接中斷
• 資源 quota 超限
• 文件操作異常

注意事項

1. 確保系統磁盤空間充足以支持臨時文件存儲。
2. 建議使用 Python 3.11 或更高版本。
3. YouTube 下載可能需要額外的身份驗證配置。
4. 合理管理 API 調用次數，避免觸發速率限制。

免費額度說明

• Speechmatics：每月免費時長 8 小時。
• Gladia：每月免費時長 10 小時。
• AssemblyAI：免費額度 $50/月。
• Deepgram：免費額度 $200/月。

📄 許可證

本項目遵循 MIT 開源協議，詳見 LICENSE 文件。

🔧 技術細節

項目結構

MCP-Video/
├── src/
│   ├── services/
│   │   ├── download/          # 下載模塊
│   │   │   └── __init__.py
│   │   └── transcription/     # 轉錄模塊
│   │       └── __init__.py
├── tests/
│   ├── test_env.py           # 環境測試
│   ├── test_downloader.py    # 下載器測試
│   └── test_transcription.py  # 轉錄器測試
└── requirements.txt          # 依賴管理文件