MCP Transcribe Online Vids

🚀 MCP 在線視頻轉錄

MCP 在線視頻轉錄是一個基於 FastMCP 的服務器項目，它為大型語言模型（LLMs）提供了訪問並轉錄來自 YouTube 和 Bilibili 在線視頻的能力。藉助 Replicate 和 0x0.st 進行臨時文件託管，讓視頻轉錄更加高效便捷。

✨ 主要特性

• 可轉錄 YouTube 和 Bilibili 視頻，並帶有時間戳輸出，方便用戶精準定位內容。
• 支持自動音頻提取和格式轉換，無需用戶手動操作。
• 通過 WhisperX 模型進行雲轉錄，確保轉錄的準確性。
• 提供大文件的臨時文件託管服務，解決大文件處理難題。

📦 安裝指南

先決條件

• Python 3.12 及以上版本。
• 推薦使用 Conda 進行環境管理。

環境設置

# 創建並激活 conda 環境
conda create --name mcp_transcribe_online_vids python=3.12
conda activate mcp_transcribe_online_vids

# 安裝所需的系統包
conda install conda-forge::uv conda-forge::ffmpeg conda-forge::sqlite

# 安裝 Python 依賴項
uv pip install -r requirements.txt

配置

1. 複製 .env.template 文件到 .env：

   cp .env.template .env
   

2. 使用你的憑證編輯 .env 文件：

   • REPLICATE_API_TOKEN：可從 Replicate 的 API 密鑰頁面 獲取。
   • ZERO_X_URL：0x0.st 實例的 URL（默認為公共實例）。
   • TEMP_FILE_PATH：臨時文件目錄。
   • LOCAL_FILE_SIZE_LIMIT：直接上傳到 API 的最大文件大小（單位：MB）。

💻 使用示例

啟動服務器

python main.py

可用工具

• get_youtube_transcript(url)：用於轉錄 YouTube 視頻。
• get_bilibili_transcript(url)：用於轉錄 Bilibili 視頻。

基礎用法

from fastmcp import MCPClient
import asyncio

async def get_transcript():
    client = MCPClient("http://localhost:8000")
    async with client:
        transcript = await client.call_tool("get_youtube_transcript",
            {"url": "https://www.youtube.com/watch?v=dQw********"})
        print(transcript)

# 運行異步函數
asyncio.run(get_transcript())

📚 詳細文檔

部署選項

有關生產環境部署，請參閱 FastMCP 傳輸選項。若要自定義傳輸，可修改 main.py 中的 mcp.run() 調用。

自託管文件存儲

強烈推薦為文件存儲搭建自己的 0x0.st 實例。你可以按照 託管說明 配置你的實例。

發展路線圖

• [ ] 添加工具以檢索視頻元數據（標題、日期、描述）。
• [ ] 添加 YAML 部署配置。
• [ ] 增加更多文件存儲選項（Google Cloud、S3）。
• [ ] 完成本地轉錄功能，使用 WhisperX。
• [ ] 支持其他媒體來源，例如 Spotify 播客。

貢獻指南

有關如何為項目做出貢獻，請參閱 Contributing 部分。

📄 許可證

[項目許可證信息]

聯繫方式

• 項目主頁：[https://github.com/your-repository]
• 作者郵箱：[你的郵箱地址]