ZapCap MCP Server

1# ZapCap MCP Server
2 
3[![PyPI version](https://badge.fury.io/py/zapcap-mcp-server.svg)](https://pypi.org/project/zapcap-mcp-server/)
4[![MCP Server](https://img.shields.io/badge/MCP-Server-blue?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMTMuMDkgOC4yNkwyMCA5TDEzLjA5IDE1Ljc0TDEyIDIyTDEwLjkxIDE1Ljc0TDQgOUwxMC45MSA4LjI2TDEyIDJaIiBmaWxsPSJ3aGl0ZSIvPgo8L3N2Zz4K)](https://modelcontextprotocol.io/)
5[![Author](https://img.shields.io/badge/by-Bogdan%20Minko-purple?style=flat)](https://bogdan01m.github.io/)
6 
7[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/bogdan01m/zapcap-mcp-server)](https://archestra.ai/mcp-catalog/bogdan01m__zapcap-mcp-server)
8 
9**NOTE**: This is an unofficial implementation of MCP Server for ZapCap.
10 
11<a href="https://glama.ai/mcp/servers/@bogdan01m/zapcap-mcp-server">
12  <img width="380" height="200" src="https://glama.ai/mcp/servers/@bogdan01m/zapcap-mcp-server/badge" alt="zapcap-mcp-server MCP server" />
13</a>
14 
15An MCP (Model Context Protocol) server that provides tools for uploading videos, creating processing tasks, and monitoring their progress through the [ZapCap API](https://zapcap.ai/).
16 
17## Requirements
18 
19- uv 
20- ZapCap API key
21 
22You can install uv from here: https://docs.astral.sh/uv/
23 
24You can get api key from ZapCap API after registation at https://zapcap.ai/ in their platform here: https://platform.zapcap.ai/dashboard/api-key
25 
26## Installation in MCP-client
27 
28Add to your MCP client `mcp.json` configuration (e.g., Claude Desktop, Cursor and etc.):
29 
30```json
31{
32  "mcpServers": {
33    "zapcap": {
34      "command": "uvx",
35      "args": ["zapcap-mcp-server"],
36      "env": {
37        "ZAPCAP_API_KEY": "your_api_key_here"
38      }
39    }
40  }
41}
42```
43 
44## Alternative Installation
45 
46```bash
47uv tool install zapcap-mcp-server
48```
49 
50## Docker Installation
51 
52You can also run the MCP server in a Docker container using the pre-built image from Docker Hub:
53 
54### Using pre-built image from Docker Hub:
55```json
56{
57  "mcpServers": {
58    "zapcap": {
59      "command": "docker",
60      "args": [
61        "run", 
62        "--rm", 
63        "--init",
64        "-i",
65        "--net=host",
66        "-v", "/home/$USER:/host/home/$USER",
67        "-e", "ZAPCAP_API_KEY=your_api_key_here",
68        "bogdan01m/zapcap-mcp-server:latest"
69      ],
70      "env": {
71        "DOCKER_CLI_HINTS": "false"
72      }
73    }
74  }
75}
76```
77 
78## Configuration
79 
80Set your ZapCap API key as an environment variable:
81 
82```bash
83export ZAPCAP_API_KEY="your_api_key_here"
84```
85 
86## Usage
87 
88### Demo Videos
89 
90**How to use:**
91 
92[<img src="https://img.youtube.com/vi/GcoyTgTVd6Q/maxresdefault.jpg" width="100%">](https://youtu.be/GcoyTgTVd6Q)
93 
94**Results:**
95 
96[<img src="https://img.youtube.com/vi/rxqAQZRiyxA/maxresdefault.jpg" width="100%">](https://youtu.be/rxqAQZRiyxA)
97 
98### Available Tools
99 
100The server provides the following tools:
101 
102### zapcap_mcp_upload_video
103Upload a video file to ZapCap.
104 
105**Parameters:**
106- `file_path`: Path to the video file
107 
108### zapcap_mcp_upload_video_by_url
109Upload a video by URL to ZapCap.
110 
111**Parameters:**
112- `url`: URL to the video file
113 
114### zapcap_mcp_get_templates
115Get available processing templates from ZapCap.
116 
117### zapcap_mcp_create_task
118Create a video processing task with full customization options.
119 
120**Parameters:**
121- `video_id`: Video ID from upload
122- `template_id`: Template ID
123- `auto_approve`: Auto approve the task (default: true)
124- `language`: Language code (default: "en")
125- `enable_broll`: Enable B-roll (default: false)
126- `broll_percent`: B-roll percentage 0-100 (default: 30)
127 
128**Subtitle options:**
129- `emoji`: Enable emoji in subtitles (default: true)
130- `emoji_animation`: Enable emoji animation (default: true)
131- `emphasize_keywords`: Emphasize keywords (default: true)
132- `animation`: Enable subtitle animation (default: true)
133- `punctuation`: Include punctuation (default: true)
134- `display_words`: Number of words to display (default: 1)
135 
136**Style options:**
137- `position_top`: Subtitle position from top (default: 60)
138- `font_uppercase`: Use uppercase font (default: true)
139- `font_size`: Font size (default: 30)
140- `font_weight`: Font weight (default: 900)
141- `font_color`: Font color (default: "#ffffff")
142- `font_shadow`: Font shadow s/m/l (default: "l")
143- `stroke`: Stroke style (default: "s")
144- `stroke_color`: Stroke color (default: "#000000")
145- `highlight_color_1`: First highlight color (default: "#2bf82a")
146- `highlight_color_2`: Second highlight color (default: "#fdfa14")
147- `highlight_color_3`: Third highlight color (default: "#f01916")
148 
149### zapcap_mcp_monitor_task
150Monitor task progress.
151 
152**Parameters:**
153- `video_id`: Video ID
154- `task_id`: Task ID
155 
156## Benefits Over Direct API Usage
157 
158### Token Management
159Unlike using curl or direct API calls where you need to manually include your API key in every request:
160 
161```bash
162# Traditional curl approach - token needed every time
163curl -X POST "https://api.zapcap.ai/upload" \
164  -H "Authorization: Bearer your_token_here" \
165  -F "file=@video.mp4"
166```
167 
168With this MCP server, your API key is configured once in the environment and automatically used for all operations:
169 
170```json
171{
172  "env": {
173    "ZAPCAP_API_KEY": "your_api_key_here"
174  }
175}
176```
177 
178### Natural Language Interface
179Instead of constructing complex API requests with parameters, you can describe what you want:
180 
181**Traditional API:** 
182```bash
183curl -X POST "https://api.zapcap.ai/tasks" \
184  -H "Authorization: Bearer token" \
185  -d '{
186    "video_id": "abc123",
187    "template_id": "viral",
188    "font_size": 30,
189    "highlight_color_1": "#00ff00",
190    "enable_broll": true,
191    "broll_percent": 40
192  }'
193```
194 
195**MCP Server:**
196```
197"Add green highlighted subtitles with 40% B-roll using viral template"
198```
199 
200### Type Safety & Validation
201- **Pydantic Integration**: All parameters are validated automatically with type checking
202 
203## Future Plans
204 
205### Testing Integration
206We're planning to add basic testing capabilities:
207 
208- **API Integration Tests**: Verify that ZapCap API calls work correctly
209- **MCP Tool Tests**: Ensure all MCP tools respond properly to requests
210 
211### Planned Features
212- **Named configurations**: Save frequently used parameter combinations ("my_brand", "youtube_style")
213- **Template enhancement**: Override template defaults with consistent brand colors/fonts
214 
215## License
216 
217MIT licence