ZA

ZapCap

Created 4 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