ZapCap

ZapCap

MCP server for ZapCap API providing video caption and B-roll generation via natural language

0
Stars
4
Forks
1
Releases

Overview

An MCP (Model Context Protocol) server for ZapCap that exposes tools to upload videos, create processing tasks, and monitor progress via the ZapCap API. This unofficial implementation enables token-based authentication via a single environment variable (ZAPCAP_API_KEY) and can be run locally or in Docker. Requirements include uv and a ZapCap API key. Install via an MCP client by adding the server to your mcp.json, or install the uv-based tool with 'uv tool install zapcap-mcp-server'. You can run the server with a Docker image (bogdan01m/zapcap-mcp-server:latest) and pass ZAPCAP_API_KEY as an environment variable. The server provides tools: zapcap_mcp_upload_video, zapcap_mcp_upload_video_by_url, zapcap_mcp_get_templates, zapcap_mcp_create_task (highly configurable: auto_approve, language, enable_broll, broll_percent, subtitle options, style options), and zapcap_mcp_monitor_task. It supports a natural-language interface to describe desired actions and validates parameters with Pydantic for type safety. This design enables simple, language-driven automation for ZapCap’s video captioning and B-roll generation workflows, with token-management benefits over direct API usage.

Details

Owner
bogdan01m
Language
Python
License
MIT License
Updated
2025-12-07

Features

zapcap_mcp_upload_video

Upload a video file to ZapCap (parameter: file_path).

zapcap_mcp_upload_video_by_url

Upload a video to ZapCap from a URL (parameter: url).

zapcap_mcp_get_templates

Get available processing templates from ZapCap.

zapcap_mcp_create_task

Create a video processing task with full customization (video_id, template_id, auto_approve, language, enable_broll, broll_percent, subtitle options, style options).

zapcap_mcp_monitor_task

Monitor task progress (video_id, task_id).

API key/token management

Environment-based API key management via ZAPCAP_API_KEY for all operations.

Natural language interface

Describe actions in natural language to perform complex operations.

Type safety with Pydantic

All parameters are validated automatically with type checking.

Tags

ZapCapMCP-Servervideo-captioningB-rollsubtitlenatural-language-interfaceAPIunofficial