Metadata-Version: 2.4
Name: mcpcn-video-extract-frames-mcp
Version: 0.1.2
Summary: MCP server for extracting frames from video as images based on scene changes
Author-email: Your Name <your.email@example.com>
License: MIT
Keywords: ffmpeg,frames,mcp,scene-detection,video
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.12
Requires-Dist: ffmpeg-python>=0.2.0
Requires-Dist: mcp[cli]>=1.9.0
Description-Content-Type: text/markdown

# Video Extract Frames MCP

从视频中提取帧为图片的 MCP Server，支持按间隔提取和场景变化检测。

## 功能

- 按固定时间间隔提取帧
- 提取首帧/末帧
- 基于场景变化检测提取关键帧
- 支持多种图片格式：png、jpg、webp、bmp、tiff

## 安装

```bash
uvx video-extract-frames-mcp
```

或通过 pip 安装：

```bash
pip install video-extract-frames-mcp
```

## 使用

```bash
video-extract-frames-mcp
```

## 工具

### extract_video_frames

从视频中按间隔或特定位置提取帧为图片。

**参数：**
- `video_path`: 输入视频路径
- `output_dir`: 输出目录
- `image_format`: 输出图片格式（默认 'png'）
- `interval_seconds`: 间隔秒数
- `extract_first`: 是否提取首帧
- `extract_last`: 是否提取末帧
- `width`/`height`: 可选缩放尺寸

### extract_scene_change_frames

基于画面变化检测提取场景切换关键帧。

**参数：**
- `video_path`: 输入视频路径
- `output_dir`: 输出目录
- `image_format`: 输出图片格式（默认 'png'）
- `scene_threshold`: 场景变化阈值（0.0~1.0，默认 0.4）
- `min_scene_gap_seconds`: 最小时间间隔
- `max_frames`: 最多导出帧数
- `width`/`height`: 可选缩放尺寸

## 依赖

- Python >=3.12
- FFmpeg（需系统安装）

## License

MIT License