Zapcap Mcp Server

ZapCap MCP 服务

注意：这是 ZapCap MCP 服务的非官方实现。

一个 MCP（模型上下文协议）服务，通过 ZapCap API 提供上传视频、创建处理任务并监控任务进度的工具。

要求

• uv
• ZapCap API 密钥

可从此处安装 uv：https://docs.astral.sh/uv/

在 https://zapcap.ai/ 注册后，可在 ZapCap 平台的此处获取 API 密钥：https://platform.zapcap.ai/dashboard/api-key

在 MCP 客户端中安装

将以下内容添加到 MCP 客户端的 mcp.json 配置中（例如 Claude Desktop、Cursor 等）：

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

其他安装方式

uv tool install zapcap-mcp-server

Docker 安装

你也可以使用 Docker Hub 上预构建的镜像，在 Docker 容器中运行 MCP 服务：

使用 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"
      }
    }
  }
}

配置

将 ZapCap API 密钥设为环境变量：

export ZAPCAP_API_KEY="your_api_key_here"

用法

演示视频

使用方法：

结果：

可用工具

此服务提供以下工具：

zapcap_mcp_upload_video

将视频文件上传到 ZapCap。

参数：

• file_path：视频文件路径

zapcap_mcp_upload_video_by_url

通过 URL 将视频上传到 ZapCap。

参数：

• url：视频文件的 URL

zapcap_mcp_get_templates

获取 ZapCap 提供的可用处理模板。

zapcap_mcp_create_task

创建视频处理任务，并提供完整的自定义选项。

参数：

• video_id：上传后获得的视频 ID
• template_id：模板 ID
• auto_approve：自动批准任务（默认值：true）
• language：语言代码（默认值："en"）
• enable_broll：启用 B-roll（默认值：false）
• broll_percent：B-roll 占比，范围为 0–100（默认值：30）

字幕选项：

• emoji：在字幕中启用表情符号（默认值：true）
• emoji_animation：启用表情符号动画（默认值：true）
• emphasize_keywords：强调关键词（默认值：true）
• animation：启用字幕动画（默认值：true）
• punctuation：包含标点符号（默认值：true）
• display_words：显示的单词数（默认值：1）

样式选项：

• position_top：字幕距顶部的位置（默认值：60）
• font_uppercase：使用大写字体（默认值：true）
• font_size：字号（默认值：30）
• font_weight：字体粗细（默认值：900）
• font_color：字体颜色（默认值："#ffffff"）
• font_shadow：字体阴影 s/m/l（默认值："l"）
• stroke：描边样式（默认值："s"）
• stroke_color：描边颜色（默认值："#000000"）
• highlight_color_1：第一种高亮颜色（默认值："#2bf82a"）
• highlight_color_2：第二种高亮颜色（默认值："#fdfa14"）
• highlight_color_3：第三种高亮颜色（默认值："#f01916"）

zapcap_mcp_monitor_task

监控任务进度。

参数：

• video_id：视频 ID
• task_id：任务 ID

相比直接使用 API 的优势

Token 管理

与使用 curl 或直接调用 API 不同，后者需要在每个请求中手动附上 API 密钥：

# Traditional curl approach - token needed every time
curl -X POST "https://api.zapcap.ai/upload" \
  -H "Authorization: Bearer your_token_here" \
  -F "[email protected]"

使用此 MCP 服务时，只需在环境中配置一次 API 密钥，即可自动用于所有操作：

{
  "env": {
    "ZAPCAP_API_KEY": "your_api_key_here"
  }
}

自然语言界面

无需构造带参数的复杂 API 请求，只需描述你想要什么：

传统 API：

curl -X POST "https://api.zapcap.ai/tasks" \
  -H "Authorization: Bearer token" \
  -d '{
    "video_id": "abc123",
    "template_id": "viral",
    "font_size": 30,
    "highlight_color_1": "#00ff00",
    "enable_broll": true,
    "broll_percent": 40
  }'

MCP 服务：

"Add green highlighted subtitles with 40% B-roll using viral template"

类型安全与验证

• Pydantic 集成：所有参数都会自动进行类型检查和验证

未来计划

测试集成

我们计划添加基本的测试功能：

• API 集成测试：验证 ZapCap API 调用是否正常
• MCP 工具测试：确保所有 MCP 工具都能正确响应请求

计划推出的功能

• 命名配置：保存常用的参数组合（“my_brand”、“youtube_style”）
• 模板增强：使用一致的品牌颜色和字体覆盖模板默认值

许可证

MIT 许可证