semvec/pypi-packages huggingface dataset:
mcpcn-video-speed-mcp 0.1.10
MCP server for changing video playback speed with proper audio sync
License: MIT
Requires Python: >=3.12
Keywords: fast-forward, ffmpeg, mcp, slow-motion, speed, video

# Video Speed MCP

A Model Context Protocol (MCP) server for changing video playback speed with proper audio sync.

## Features

- **Speed Control**: Adjust video playback speed
- Supports both fast-forward (>1x) and slow-motion (<1x)
- Proper audio pitch correction using atempo filter
- Handles extreme speed changes (very slow or very fast)
- Audio and video remain synchronized

## Installation

Install via uvx (recommended):

```bash
uvx video-speed-mcp
```

Or install via pip:

```bash
pip install video-speed-mcp
```

## Usage

Run the MCP server:

```bash
video-speed-mcp
```

## Requirements

- Python >=3.12
- FFmpeg installed on your system

## Tool

### `change_video_speed`

Change video playback speed:
- `video_path`: Input video file path
- `output_video_path`: Output video file path
- `speed_factor`: Speed multiplier (e.g., 2.0 for 2x speed, 0.5 for half speed)

### Examples

- `speed_factor=2.0`: Double speed (video plays 2x faster)
- `speed_factor=0.5`: Half speed (slow motion)
- `speed_factor=1.5`: 1.5x speed
- `speed_factor=0.25`: Quarter speed (very slow motion)
- `speed_factor=4.0`: 4x speed (very fast)

## License

MIT License
mcpcn-video-cover-mcp 0.2.8
MCP server for adding cover image/first frame and fade transitions to videos
License: MIT
Requires Python: >=3.12
Keywords: cover, fade, ffmpeg, mcp, thumbnail, transition, video

# Video Cover MCP

A Model Context Protocol (MCP) server for adding cover images (real first frames) and fade transitions to videos.

## Features

- **Add Cover Image**: Prepend a static image as real first frames (re-encodes video stream)
- **Fade Transitions**: Add fade-in and fade-out effects to videos

## Installation

Install via uvx (recommended):

```bash
uvx video-cover-mcp
```

Or install via pip:

```bash
pip install video-cover-mcp
```

## Usage

Run the MCP server:

```bash
video-cover-mcp
```

## Requirements

- Python >=3.12
- FFmpeg installed on your system

## Tools Available

### `add_cover_image`

Prepend a cover image as real first frames at the beginning of the video.

**Parameters:**
- `video_path`: Input video file path
- `cover_image_path`: Cover image file path (supports PNG, JPG, etc.)
- `output_video_path`: Output video file path
- `cover_duration`: Duration to display the cover image in seconds (default: 3.0)
- `fade_duration`: Deprecated (kept for compatibility)

Note: If `output_video_path` is not provided, output defaults to an `.mp4` file for better compatibility.

**Example:**
```python
add_cover_image(
    video_path="/path/to/input.mp4",
    cover_image_path="/path/to/cover.jpg",
    output_video_path="/path/to/output.mp4",
    cover_duration=5.0,
    fade_duration=1.0
)
```

### `add_basic_transitions`

Add fade-in or fade-out transition effects to a video.

**Parameters:**
- `video_path`: Input video file path
- `output_video_path`: Output video file path
- `transition_type`: Transition type - 'fade_in' or 'fade_out'
- `duration_seconds`: Transition duration in seconds (must be positive)

**Example:**
```python
add_basic_transitions(
    video_path="/path/to/input.mp4",
    output_video_path="/path/to/output.mp4",
    transition_type="fade_in",
    duration_seconds=2.0
)
```

## License

MIT License
mcpcn-video-compressor-mcp 0.1.6
MCP server for video compression and optimization: bitrate, resolution, frame rate, and codec adjustment
License: MIT
Requires Python: >=3.12
Keywords: bitrate, codec, compression, ffmpeg, mcp, optimization, video

# Video Compressor MCP

A Model Context Protocol (MCP) server for video compression and optimization: bitrate, resolution, frame rate, and codec adjustment.

## Features

- **Bitrate Control**: Adjust video bitrate for size optimization
- **Resolution Scaling**: Change video resolution with aspect ratio preservation
- **Frame Rate Adjustment**: Modify video frame rates
- **Codec Selection**: Choose optimal video codecs for different use cases
- **Smart Fallback**: Automatic audio copy with re-encoding fallback

## Installation

Install via uvx (recommended):

```bash
uvx video-compressor-mcp
```

Or install via pip:

```bash
pip install video-compressor-mcp
```

## Usage

Run the MCP server:

```bash
video-compressor-mcp
```

## Requirements

- Python >=3.12
- FFmpeg installed on your system

## Tools Available

1. `set_video_bitrate` - Adjust video bitrate
2. `set_video_resolution` - Change video resolution
3. `set_video_frame_rate` - Modify frame rate
4. `set_video_codec` - Change video codec

## License

MIT License
mcpcn-video-concatenate-mcp 0.1.7
MCP server for concatenating videos with optional transition effects
License: MIT
Requires Python: >=3.12
Keywords: concatenate, ffmpeg, mcp, merge, transition, video

# Video Concatenate MCP

MCP 服务器，用于拼接多个视频文件，支持 30+ 种转场效果。

## 功能特性

- 支持多个视频文件拼接
- 自动标准化视频分辨率和帧率
- 支持 30+ 种转场效果（两个视频之间）
- 音频自动交叉淡入淡出

## 安装

```bash
uvx video-concatenate-mcp
```

或通过 pip 安装：

```bash
pip install video-concatenate-mcp
```

## 依赖

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

## 可用工具

### 1. `concatenate_videos`

拼接视频序列，可选转场效果。

**参数：**
- `video_paths`: 输入视频路径列表（至少 1 个）
- `output_video_path`: 输出视频文件路径
- `transition_effect`: 转场效果（可选）
- `transition_duration`: 转场时长（秒，使用转场时必填）

**示例：**

```python
# 简单拼接
concatenate_videos(
    ["/path/video1.mp4", "/path/video2.mp4"],
    "/path/output.mp4"
)

# 带转场效果
concatenate_videos(
    ["/path/video1.mp4", "/path/video2.mp4"],
    "/path/output.mp4",
    transition_effect="dissolve",
    transition_duration=1.0
)
```

### 2. `list_transition_effects`

列出所有支持的转场效果。

## 支持的转场效果

| 类别 | 效果 |
|------|------|
| 淡入淡出 | dissolve, fade, fadeblack, fadewhite, fadegrays |
| 擦除 | wipeleft, wiperight, wipeup, wipedown |
| 滑动 | slideleft, slideright, slideup, slidedown |
| 平滑 | smoothleft, smoothright, smoothup, smoothdown |
| 圆形 | circlecrop, circleopen, circleclose |
| 矩形 | rectcrop, vertopen, vertclose, horzopen, horzclose |
| 对角线 | diagtl, diagtr, diagbl, diagbr |
| 切片 | hlslice, hrslice, vuslice, vdslice |
| 其他 | distance, pixelize, radial, hblur |

## 许可证

MIT License
mcpcn-video-extract-frames-mcp 0.1.5
MCP server for extracting frames from video as images based on scene changes
License: MIT
Requires Python: >=3.12
Keywords: ffmpeg, frames, mcp, scene-detection, video

# 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
mcpcn-video-trim-mcp 0.1.4
MCP server for trimming video segments by time range
License: MIT
Requires Python: >=3.12
Keywords: cut, ffmpeg, mcp, trim, video

# Video Trim MCP

按时间范围裁剪视频片段的 MCP Server。

## 功能

- 按指定时间范围裁剪视频
- 优先使用 codec copy 避免重编码
- 支持 HH:MM:SS 或秒数格式的时间输入

## 安装

```bash
uvx video-trim-mcp
```

或通过 pip 安装：

```bash
pip install video-trim-mcp
```

## 使用

```bash
video-trim-mcp
```

## 工具

### trim_video

按指定时间范围裁剪视频片段。

**参数：**
- `video_path`: 输入视频文件路径
- `output_video_path`: 输出视频文件路径
- `start_time`: 开始时间（支持 'HH:MM:SS' 或秒数）
- `end_time`: 结束时间（支持 'HH:MM:SS' 或秒数）

## 依赖

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

## License

MIT License
mcpcn-video-image-watermark-mcp 0.1.5
MCP server for adding image watermarks and overlays to videos
License: MIT
Requires Python: >=3.12
Keywords: ffmpeg, image, logo, mcp, overlay, video, watermark

# Video Image Watermark MCP

A Model Context Protocol (MCP) server for adding image watermarks and overlays to videos.

## Features

- **Image Overlay**: Add logos, watermarks, or any image to videos
- Support for transparent PNG images
- Customizable position, size, and opacity
- Timed overlays with start/end time support
- Automatic aspect ratio preservation

## Installation

Install via uvx (recommended):

```bash
uvx video-image-watermark-mcp
```

Or install via pip:

```bash
pip install video-image-watermark-mcp
```

## Usage

Run the MCP server:

```bash
video-image-watermark-mcp
```

## Requirements

- Python >=3.12
- FFmpeg installed on your system

## Tool

### `add_image_overlay`

Add image overlay to video:
- `video_path`: Input video file path
- `output_video_path`: Output video file path
- `image_path`: Overlay image path (supports transparent PNG)
- `position`: Position preset ('top_left', 'top_right', 'bottom_left', 'bottom_right', 'center') or custom 'x=...:y=...'
- `opacity`: Transparency (0.0-1.0)
- `start_time`: When to start showing the overlay
- `end_time`: When to stop showing the overlay
- `width`: Target width (auto-calculates height if not specified)
- `height`: Target height (auto-calculates width if not specified)

## License

MIT License
mcpcn-video-text-watermark-mcp 0.1.6
MCP server for adding text watermarks and overlays to videos
License: MIT
Requires Python: >=3.12
Keywords: ffmpeg, mcp, overlay, text, video, watermark

# Video Text Watermark MCP

A Model Context Protocol (MCP) server for adding text watermarks and overlays to videos.

## Features

- **Text Watermark**: Add permanent text watermarks to videos
- **Text Overlay**: Add timed text overlays that appear during specific time ranges
- Support for Chinese and other Unicode characters
- Customizable font, color, size, position, and opacity
- Background box support

## Installation

Install via uvx (recommended):

```bash
uvx video-text-watermark-mcp
```

Or install via pip:

```bash
pip install video-text-watermark-mcp
```

## Usage

Run the MCP server:

```bash
video-text-watermark-mcp
```

## Requirements

- Python >=3.12
- FFmpeg installed on your system

## Tools

### `add_text_watermark`

Add a permanent text watermark to video:
- `video_path`: Input video file path
- `output_video_path`: Output video file path
- `watermark_text`: Text content
- `font_size`: Font size (default 24)
- `font_color`: Font color (default 'white')
- `position`: Position preset or custom coordinates
- `opacity`: Transparency (0.0-1.0)
- `font_file`: Custom font file path
- `box`: Enable background box

### `add_text_overlay`

Add timed text overlays:
- `video_path`: Input video file path
- `output_video_path`: Output video file path
- `text_elements`: List of text overlay configurations

## License

MIT License
mcpcn-video-to-gif 0.1.7
MCP server for converting video to high-quality GIF using FFmpeg
License: MIT
Requires Python: >=3.12
Keywords: animation, conversion, ffmpeg, gif, mcp, video

# Video to GIF Converter MCP

基于 MCP (Model Context Protocol) 的视频转 GIF 服务器，使用 FFmpeg 两遍调色板优化法生成高质量 GIF。

## 功能特性

- **两遍调色板优化**: palettegen/paletteuse 两遍法，生成高质量 GIF
- **帧率控制**: 自定义 GIF 帧率
- **尺寸调整**: 支持宽度/高度设置，保持或不保持宽高比
- **时间裁剪**: 指定起始时间
- **区域裁剪**: 指定裁剪区域 (x, y, w, h)
- **调色算法**: 支持 floyd_steinberg、bayer、sierra2_4a 等
- **颜色数控制**: 2-256 色调色板
- **循环设置**: 无限循环或指定次数

## 安装

通过 uvx 安装（推荐）:

```bash
uvx mcpcn-video-to-gif
```

或通过 pip 安装:

```bash
pip install mcpcn-video-to-gif
```

## 使用方法

启动 MCP 服务器:

```bash
mcpcn-video-to-gif
```

## 系统要求

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

## 环境变量

- `FFMPEG_BINARY`: 指定 FFmpeg 可执行文件路径
- `FFPROBE_BINARY`: 指定 FFprobe 可执行文件路径

## 工具说明

### convert_video_to_gif

将视频片段高质量导出为 GIF。

**参数:**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| video_path | string | 是 | - | 输入视频路径 |
| output_gif_path | string | 是 | - | 输出 GIF 路径（需以 .gif 结尾） |
| fps | int | 否 | 8 | GIF 帧率，建议 8~20 |
| width | int | 否 | None | 目标宽度 |
| height | int | 否 | None | 目标高度 |
| keep_aspect | bool | 否 | True | 是否保持纵横比 |
| start_time | string/float | 否 | None | 起始时间（秒或 'HH:MM:SS'） |
| dither | string | 否 | "floyd_steinberg" | 调色算法 |
| max_colors | int | 否 | 256 | 调色板颜色数 (2-256) |
| loop | int | 否 | 0 | 循环次数（0=无限循环） |
| crop | dict | 否 | None | 裁剪参数 {"x":0,"y":0,"w":320,"h":240} |
| scale_flags | string | 否 | "lanczos" | 缩放插值算法 |
| bayer_scale | int | 否 | 3 | bayer 调色的缩放因子 (0-5) |
| palette_stats_mode | string | 否 | "diff" | 调色板统计模式 |
| use_reserve_transparent | bool | 否 | False | 是否保留透明色槽 |
| alpha_threshold | int | 否 | 128 | 透明度阈值 (0-255) |

**支持的调色算法 (dither):**

| 算法 | 说明 |
|------|------|
| none | 不使用抖动 |
| bayer | Bayer 有序抖动 |
| floyd_steinberg | Floyd-Steinberg 误差扩散 (默认) |
| sierra2_4a | Sierra-2-4A 抖动 |
| burkes | Burkes 抖动 |

**调色板统计模式 (palette_stats_mode):**

| 模式 | 说明 |
|------|------|
| single | 单帧统计 |
| diff | 差异帧统计 (默认，适合动画) |
| full | 全帧统计 |

## 使用示例

```python
# 基本转换
convert_video_to_gif(
    video_path="/path/to/video.mp4",
    output_gif_path="/path/to/output.gif"
)

# 高质量设置
convert_video_to_gif(
    video_path="/path/to/video.mp4",
    output_gif_path="/path/to/output.gif",
    fps=15,
    width=480,
    max_colors=256,
    dither="floyd_steinberg"
)

# 裁剪区域
convert_video_to_gif(
    video_path="/path/to/video.mp4",
    output_gif_path="/path/to/output.gif",
    crop={"x": 100, "y": 50, "w": 320, "h": 240},
    start_time="00:00:05"
)
```

## License

MIT License
mcpcn-video-transitions-mcp 0.1.7
MCP server for adding multiple video entrance and exit animations (fade, slide, zoom, wipe, circle transitions)
License: MIT
Requires Python: >=3.12
Keywords: animation, fade, ffmpeg, mcp, transitions, video

# Video Transitions MCP

为视频添加多种进入和退出动画效果的 MCP 服务器。

## 支持的效果

- 淡入淡出 (fade_in, fade_out)
- 滑动 (slide_in/out: left, right, top, bottom)
- 缩放 (zoom_in, zoom_out)
- 擦除 (wipe_left, wipe_right)
- 圆形 (circle_open, circle_close)

## 安装

```bash
uv sync
```

## 使用

```bash
uv run video-transitions-mcp
```
mcpcn-video-audio-merge-mcp 0.1.4
MCP server for merging video and audio files
License: MIT
Requires Python: >=3.12
Keywords: audio, ffmpeg, mcp, merge, video

# Video Audio Merge MCP

将视频文件与音频文件合并的 MCP Server。

## 功能

- 将音频文件合并到视频文件中
- 支持替换原有音频或添加新音频轨道
- 支持多种音频格式：mp3、aac、wav、flac、m4a、ogg、wma
- 支持批量处理多个视频文件

## 安装

```bash
uvx mcpcn-video-audio-merge-mcp
```

或通过 pip 安装:

```bash
pip install mcpcn-video-audio-merge-mcp
```

## 使用

```bash
mcpcn-video-audio-merge-mcp
```

## 工具

### merge_video_audio

将音频文件合并到视频文件中。

**参数:**
- `video_paths`: 输入视频文件路径列表,支持多个视频
- `audio_path`: 输入音频文件路径
- `output_dir`: 输出目录,合并后的视频文件保存位置
- `replace_audio`: 是否替换原有音频(默认 True),如果为 False 则添加新音频轨道
- `audio_codec`: 音频编码格式(默认 'aac')

## 依赖

- Python >=3.12
- FFmpeg(需系统安装)

## License

MIT License