MCQ 视频生成器 🎬 ✨

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

📋 概述

MCQ 视频生成器是一款强大的工具，旨在自动将 CSV 格式的多项选择题转换成带有同步语音叙述的专业视频演示。非常适合教育工作者、培训师和内容创作者，他们希望通过增强学习材料而不必手动编辑视频来提升教学效果。

✨ 功能

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

🛠️ 安装

预备条件

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

设置

1. 克隆仓库

git clone https://github.com/yourusername/mcp-video-gen.git
cd mcp-video-gen

2. 安装所需依赖

pip install -e .
# 或
pip install pandas pillow gtts moviepy

3. 安装额外的 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

# 创建一个 MCP 服务器
mcp = FastMCP("mcq_video_generator")

# 示例用法
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	背景颜色	(0, 127, 215)
font_color_rgb	文本颜色	(255, 255, 255)

📋 处理流程

graph TD
    A[加载 CSV 数据] --> B[生成图像]
    B --> C[创建 TTS 音频]
    C --> D[组合成视频片段]
    D --> E[合并最终视频]
    E --> F[输出 MP4 文件]

🔍 技术细节

该工具执行以下步骤：

1. 📑 从 CSV 文件读取 MCQ 数据
2. 🖼️ 为每个 MCQ 生成带有适当文本格式的图像
3. 🎙️ 使用 Google 的文本转语音（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 许可证 - 查看 LICENSE 文件以获取详情。

👥 贡献

欢迎贡献！请随时提交拉取请求。

---

由 ❤️ 制作，专为教育工作者和内容创作者

</中文翻译>