JinDaGe - mcp-video-digest MCP Details

article

README

🚀 MCP 视频转录工具

MCP 视频转录工具是一款强大的视频处理软件，它能从 YouTube 等平台下载视频，并将视频音频转换为文字。借助多种先进语音识别技术，可帮助用户快速完成视频转录任务。

🚀 快速开始

你可以按照以下步骤启动并使用 MCP 视频转录工具：

克隆项目仓库：

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

安装依赖项：

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)

✨ 主要特性

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

📦 安装指南

安装步骤

克隆项目仓库：

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

安装依赖项：

uv pip install -r requirements.txt

💻 使用示例

基础用法

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)

📚 详细文档

项目结构

MCP-Video/
├── src/
│   ├── services/
│   │   ├── download/          # 下载模块
│   │   │   └── __init__.py
│   │   └── transcription/     # 转录模块
│   │       └── __init__.py
├── tests/
│   ├── test_env.py           # 环境测试
│   ├── test_downloader.py    # 下载器测试
│   └── test_transcription.py  # 转录器测试
└── 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 test

开发指南

新服务添加

在 src/services/transcription/ 目录下创建新类，继承自 BaseTranscriptionService 并实现 transcribe 方法。

自定义下载器开发

在 src/services/download/ 目录下扩展或修改现有下载器，建议参考 YouTubeDownloader 类。

依赖管理

使用 uv pip install package_name 安装新依赖。
使用 uv pip freeze > requirements.txt 导出当前依赖。

错误处理

服务内置了完善的错误处理机制，能够自动处理以下问题：

API 请求失败。
网络连接中断。
资源 quota 超限。
文件操作异常。

注意事项

⚠️ 重要提示

确保系统磁盘空间充足以支持临时文件存储。

建议使用 Python 3.11 或更高版本。

YouTube 下载可能需要额外的身份验证配置。

合理管理 API 调用次数，避免触发速率限制。

免费额度说明

| 服务名称 | 免费额度 | | ---- | ---- | | Speechmatics | 每月免费时长 8 小时 | | Gladia | 每月免费时长 10 小时 | | AssemblyAI | 免费额度 $50/月 | | Deepgram | 免费额度 $200/月 |

📄 许可证

本项目遵循 MIT 开源协议，详见 LICENSE 文件。

mcp-video-digest