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          # 依赖管理文件