ZA

ZapCap

Created 10 months ago

An unofficial implementation of MCP Server for ZapCap providing tools for video processing.

development documentation public

What is ZapCap?

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

Documentation

ZapCap MCP Server

Requirements

  • uv
  • ZapCap API key

You can install uv from here: https://docs.astral.sh/uv/

You can get api key from ZapCap API after registration at https://zapcap.ai/ in their platform here: https://platform.zapcap.ai/dashboard/api-key

Installation in MCP-client

Add to your MCP client mcp.json configuration (e.g., Claude Desktop, Cursor and etc.):

{
  "mcpServers": {
    "zapcap": {
      "command": "uvx",
      "args": ["zapcap-mcp-server"],
      "env": {"ZAPCAP_API_KEY": "your_api_key_here"}
    }
  }
}

Alternative Installation

uv tool install zapcap-mcp-server

Docker Installation

You can also run the MCP server in a Docker container using the pre-built image from Docker Hub:\n\n### Using pre-built image from Docker Hub:

{
  "mcpServers": {
    "zapcap": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--init",
        "-i",
        "--net=host",
        "-v",
        "/home/$USER:/host/home/$USER",
        "-e",
        "ZAPCAP_API_KEY=your_api_key_here",
        "bogdan01m/zapcap-mcp-server:latest"
      ],
      "env": {"DOCKER_CLI_HINTS": "false"}
    }
  }
}

Configuration

Set your ZapCap API key as an environment variable:

export ZAPCAP_API_KEY="your_api_key_here"

Usage# Demo Videos

How to use: Results: \n\n### Available Tools The server provides the following tools:

  • zapcap_mcp_upload_video
  • zapcap_mcp_upload_video_by_url
  • zapcap_mcp_get_templates
  • zapcap_mcp_create_task
  • zapcap_mcp_monitor_task

Benefits Over Direct API Usage# Token Management

Unlike using curl or direct API calls where you need to manually include your API key in every request.\n\n### Natural Language Interface Instead of constructing complex API requests with parameters, you can describe what you want.\n\n### Type Safety & Validation

  • Pydantic Integration: All parameters are validated automatically with type checking

Future Plans# Testing Integration

We're planning to add basic testing capabilities.\n\n### Planned Features

  • Named configurations: Save frequently used parameter combinations.
  • Template enhancement: Override template defaults with consistent brand colors/fonts.

Server Config

{
  "mcpServers": {
    "zapcap-server": {
      "command": "npx",
      "args": [
        "zapcap"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: No

Project Info

Hosted Featured
Created At: Jul 17, 2025
Updated At: Aug 07, 2025
Author: Bogdan Minko
Category: community
License: MIT licence
Tags:
development documentation public