MCP 视频转录工具

项目简介

MCP Video 转录工具是一款功能强大的视频处理软件，支持从 YouTube 和其他平台下载视频并将其音频转换为文字。该工具集成了多种先进的语音识别技术，能够帮助用户快速完成视频转录任务。

功能特点

• 多平台兼容：支持 YouTube、Vimeo 等主流视频平台
• 高效下载：内置强大下载器，可处理各种视频格式
• 精准转录：整合 Deepgram、Gladia、AssemblyAI 和 Speechmatics 等知名语音识别服务
• 灵活配置：支持自定义 API 密钥和参数设置
• 智能错误处理：自动检测并修复下载和转录过程中出现的问题

项目结构

MCP-Video/
├── src/
│   ├── services/
│   │   ├── download/          # 下载模块
│   │   │   └── __init__.py
│   │   └── transcription/     # 转录模块
│   │       └── __init__.py
├── tests/
│   ├── test_env.py           # 环境测试
│   ├── test_downloader.py    # 下载器测试
│   └── test_transcription.py  # 转录器测试
└── requirements.txt          # 依赖管理文件

安装指南

安装步骤

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 文件。