AI导哈

多选题视频生成器

将CSV格式的多选题自动转换为带有同步音频讲解的专业视频演示，适用于教育工作者、培训师和内容创作者。

  • by Yash-Kavaiya
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 yash-kavaiya/mcp-video-gen

使用说明

MCQ视频生成器🎬 ✨

将你的多项选择题转化为引人入胜的视频演示

📋 概述

MCQ视频生成器是一个功能强大的工具，旨在自动将CSV格式的多项选择题转换为具有同步音频旁白的专业视频演示。非常适合希望增强学习材料而无需手动视频编辑的教育工作者、培训师和内容创作者。

✨ 特性

  • 🎥 自动视频创建 -将MCQ的CSV文件转换为完整的视频
  • 🔊 文本转语音叙述 -所有文本元素的自动音频生成
  • 🌐 多语言支持 -通过gTTS兼容多种语言
  • 🎨 可定制的造型 -控制颜色、字体和尺寸
  • 🔄 批处理 -在一次运行中处理多个问题

🛠️ 安装

先决条件

  • Python 3.12或更高版本
  • 必需的字体文件（默认值： HindVadodara-Light.ttf)

设置

  1. 克隆存储库
git clone https://github.com/yourusername/mcp-video-gen.git
cd mcp-video-gen
  1. 安装所需的依赖项
pip install -e .
# or
pip install pandas pillow gtts moviepy
  1. 安装其他MCP依赖项
pip install mcp[cli]>=1.6.0

🚀 用法

基本用法

python main.py

作为MCP工具

该工具设计用于在MCP（机器控制协议）框架内工作：

from mcp.server.fastmcp import FastMCP
from main import create_mcq_video

# Create an MCP server
mcp = FastMCP("mcq_video_generator")

# Example usage
result = await create_mcq_video(
    csv_file_path="your_questions.csv",
    output_filename="my_quiz_video.mp4"
)

📊 输入格式

CSV文件应包含问题和答案选项列。示例格式：

问题 A B C D 答案
什么是1+1？ A.1 B.2 C.3 D.4 答案：B.2
法国首都？ A.伦敦 B.柏林 C.巴黎 D.罗马 答案：C.巴黎

⚙️ 配置选项

参数 说明 默认值
csv_file_path 输入CSV文件的路径 必需
output_filename 最终视频名称 “Gyan_Dariyo_final_video.mp4”
language TTS的语言代码 “en”
font_path 字体文件路径 “HindVadodara Light.ttf”
font_size 幻灯片上的文字大小 70
img_width 视频宽度（像素） 1920
img_height 视频高度（像素） 1080
bg_color_rgb 背景颜色 （0127215）
font_color_rgb 文本颜色 （255255255）

📋 工艺流程

graph TD
    A[Load CSV Data] --> B[Generate Images]
    B --> C[Create TTS Audio]
    C --> D[Combine into Video Clips]
    D --> E[Concatenate Final Video]
    E --> F[Output MP4 File]

🔍 技术细节

该工具执行以下步骤：

  1. 📑 从CSV文件读取MCQ数据
  2. 🖼️ 为每个MCQ生成具有适当文本格式的图像
  3. 🎙️ 使用谷歌的文本转语音（gTTS）创建音频旁白
  4. 🎞️ 将每个图像和音频组合成单独的视频片段
  5. 🎬 将所有剪辑连接成最终视频演示文稿

⚠️ 故障排除

常见问题

  • 找不到字体错误：确保指定的字体文件存在于工作目录中
  • 空CSV错误：验证CSV文件是否包含有效数据
  • 音频生成失败：检查互联网连接（gTTS需要）

字体要求

默认字体设置为“HindVadodara Light.ttf”。如果使用其他字体：

result = await create_mcq_video(
    csv_file_path="questions.csv",
    font_path="path/to/your/font.ttf"
)

📝 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

👥 贡献

欢迎投稿！请随时提交拉取请求。

由以下材料制成❤️ 面向教育工作者和内容创作者

相关 MCP