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]
• 作者邮箱：[你的邮箱地址]