AI导哈

视频处理服务器

ZapCap MCP Server是一个基于Model Context Protocol的服务器，提供视频上传、处理任务创建和进度监控等功能，通过ZapCap API实现。

  • by bogdanminko
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 bogdan01m/zapcap-mcp-server

使用说明

ZapCap MCP服务器

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

MCP（模型上下文协议）服务器，提供上传视频、创建处理任务以及通过 ZapCap API.

需求

  • 紫外线
  • ZapCap API密钥

您可以从这里安装uv：https://docs.astral.sh/uv/

您可以在注册后从ZapCap api获得api密钥https://zapcap.ai/在他们的平台上：https://platform.zapcap.ai/dashboard/api-key

在MCP客户端中安装

添加到您的MCP客户端 mcp.json 配置（例如，克劳德桌面、光标等）：

{
  "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_cp_upload_video

将视频文件上传到ZapCap。

参数：

  • file_path：视频文件的路径

zapcap_cp_upload_video_by_url

通过URL将视频上传到ZapCap。

参数：

  • url：视频文件的URL

zapcap_mcp_get_templates

从ZapCap获取可用的处理模板。

zapcap_cp_ce_task

创建具有完全自定义选项的视频处理任务。

参数：

  • video_id：上传的视频ID
  • template_id：模板ID
  • auto_approve：自动批准任务（默认值：true）
  • language：语言代码（默认值：“en”）
  • enable_broll：启用B-roll（默认值：false）
  • broll_percent：B滚动百分比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直接使用带来的好处

许可证管理

与使用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 "file=@video.mp4"

使用此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许可证

相关 MCP