clipacanvas

Clip.A.Canvas MCP 服务

一个通用的 MCP（Model Context Protocol）服务，可将 Clip.A.Canvas 的 HTML 转视频渲染功能作为 MCP 工具提供。适用于 Claude Desktop、ChatGPT、Antigravity CLI（agy）、Claude Code，以及任何基于 STDIO/HTTPS 的 MCP 客户端。

功能

• 通用 MCP 工具 — 通过 MCP 协议提供 render_video 和 render_video_to_file
• 随处可用 — 支持 Claude Desktop、ChatGPT、Antigravity CLI、Claude Code 等
• 本地渲染 — 无需上传，无需云服务；Chromium 和 FFmpeg 在你的机器上运行
• Base64 或文件输出 — 以 Base64 字符串形式返回视频，或直接保存到指定路径

安装

客户端配置

1. Antigravity CLI（agy）

将以下内容添加到 mcp_config.json（通常位于 ~/.gemini/antigravity-cli/mcp_config.json）：

{
  "mcpServers": {
    "clipacanvas": {
      "command": "uvx",
      "args": ["--from", "clipacanvas-mcp", "clipmcp"]
    }
  }
}

运行 agy inspect，确认服务已成功加载。

2. Claude Code

claude mcp add -s user clipacanvas -- cmd /c uvx --from clipacanvas-mcp clipmcp

3. Codex CLI

codex mcp add clipacanvas -- uvx --from clipacanvas-mcp clipmcp

说明

如果 codex mcp list 为 Clip.A.Canvas 显示 Auth: Unsupported，这是完全正常的！此状态仅表示该服务运行时不需要外部 OAuth 身份验证（本地 STDIO MCP 服务正是如此）。

从 PyPI 安装

pip install clipacanvas-mcp
# or
uv tool install clipacanvas-mcp  # gives 'clipacanvas-mcp' command

配置

环境变量（均为可选）：

变量	默认值	描述
CLIPACANVAS_FFMPEG_EXE	自动检测	FFmpeg 可执行文件的路径
CLIPACANVAS_BROWSERS_PATH	自动检测	Playwright 浏览器的路径
CLIPACANVAS_MAX_DURATION	12	最大渲染时长（秒）
CLIPACANVAS_DEFAULT_WIDTH	540	默认视频宽度
CLIPACANVAS_DEFAULT_HEIGHT	960	默认视频高度
CLIPACANVAS_DEFAULT_BITRATE	5M	默认 FFmpeg 比特率
CLIPACANVAS_DEFAULT_FRAME_RATE	60	默认帧率

MCP 工具

render_video

只读提示：否 | 破坏性提示：否

将 HTML/CSS/JS 渲染为 MP4，并以 Base64 编码形式返回。

参数：

{
  "code": "<!DOCTYPE html><html>...</html>",
  "width": 540,
  "height": 960,
  "bitrate": "5M",
  "frame_rate": 60,
  "max_duration": 12
}

**返回：**包含视频元数据和 Base64 编码 MP4 数据的文本内容。

render_video_to_file

只读提示：否 | 破坏性提示：是（覆盖文件）

功能与上方相同，但会将 MP4 直接保存到 output_path。

参数：

{
  "code": "<!DOCTYPE html><html>...</html>",
  "output_path": "/absolute/path/to/video.mp4",
  "width": 540,
  "height": 960
}

在 AI 客户端中使用

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "clipacanvas": {
      "command": "uvx",
      "args": ["clipacanvas-mcp"]
    }
  }
}

ChatGPT（通过 Bridge）

若要在 ChatGPT 中使用此本地工具，可以使用 MCP-to-HTTPS 桥接工具（如 mcp-proxy），或将其托管在公共 URL 上。ChatGPT 目前要求官方“App”集成使用 HTTPS 端点。

其他客户端（Codex、Qwen Coder 等）

由于这是一个标准的 STDIO 服务，任何支持 MCP 的客户端都可以使用它。使用 uvx clipacanvas-mcp 或 python -m clipacanvas_mcp.server 作为启动命令。

隐私政策

Clip.A.Canvas 是一款本地优先的应用。

• 数据收集：用户数据、代码片段或渲染后的视频都不会上传到任何服务器。
• 处理：所有 HTML/CSS/JS 渲染均在你机器上的本地 Chromium 实例中完成。
• 存储：渲染后的 MP4 文件只会保存到你指定的目录。
• 第三方服务：无。

要求

• Python 3.10+
• FFmpeg（系统级安装、通过 imageio-ffmpeg 安装，或设置 CLIPACANVAS_FFMPEG_EXE）
• Playwright Chromium：如果缺失，会在首次渲染时自动安装。

许可证

MIT