CutPro MCP

CutPro MCP

一个用于 AI 图像、视频、虚拟形象和片段的 Model Context Protocol（MCP）服务。它将完整的 CutPro API 作为工具开放，使大模型能够：

• 使用各种顶级模型生成图像和视频：Veo、Kling、Seedance、Wan、MiniMax、Nano Banana、GPT Image、Seedream 等；可根据提示词或参考图生成，并显示每个模型的实时价格。
• 创建 AI 虚拟形象：制作在照片和视频中保持一致的逼真人物，然后将他们替换到任意视频中，同时保留场景、镜头、动作和声音。
• 剪辑长视频和直播：查找精彩片段并渲染最终 MP4。
• 发布和定时发布：现在或在指定时间，将任意片段、生成的视频或虚拟形象视频发布到 TikTok、Instagram、YouTube、Facebook、Threads、LinkedIn、Pinterest 和 Bluesky。
• 转录：将任意音频或视频转录为带时间戳的字幕（SRT、VTT、文本或 JSON）。

主要功能

• 始终保持同步。每个 v1 端点都是一个工具，均根据实时 API 规范生成：图像和视频生成、虚拟形象、工作区、余额、视频和上传、剪辑、片段、频道和直播监控、模板、渲染、转录、帖子和连接。
• 随处运行。为本地客户端（Claude Code、Cursor、Claude Desktop、Windsurf、VS Code、Cline、Zed）提供 stdio，并为 ChatGPT 和 Claude.ai 提供带 OAuth 的托管 Streamable HTTP 端点。
• 支持最新协议。使用 MCP 2026-07-28（无状态、server/discover、可缓存列表、多轮请求）及所有更早版本，共用同一个端点。
• 结果可实时查看。支持 MCP Apps 的客户端会以内嵌播放器显示生成的图像和视频、虚拟形象、片段及渲染结果；播放器会跟踪任务直到就绪，并提供按钮供用户在 CutPro 中打开、为图像添加动画或安排帖子发布。
• 消费前先确认。在支持 elicitation 的客户端中，每次会扣除点数的调用都会显示价格，并等待用户确认后才扣费。

开始使用

要求

• Node.js 18 或更高版本。
• 一个 CutPro 账户（任意套餐）和一个 API 密钥。请在 cut.pro/studio/me/api-keys 生成密钥。
• 一个兼容 MCP 的客户端。

标准配置

大多数客户端使用相同的 JSON。在 env 下添加 API 密钥：

{
	"mcpServers": {
		"cutpro": {
			"command": "npx",
			"args": ["-y", "@cutpro/mcp@latest"],
			"env": { "CUTPRO_API_KEY": "<your-api-key>" }
		}
	}
}

安装

使用按钮完成安装后，将 CUTPRO_API_KEY 添加到服务的 env 中。

claude mcp add cutpro --env CUTPRO_API_KEY=<your-api-key> -- npx -y @cutpro/mcp@latest

{
	"mcpServers": {
		"cutpro": {
			"command": "npx",
			"args": ["-y", "@cutpro/mcp@latest"],
			"env": { "CUTPRO_API_KEY": "<your-api-key>" }
		}
	}
}

gemini mcp add cutpro npx -y @cutpro/mcp@latest -e CUTPRO_API_KEY=<your-api-key>

[mcp_servers.cutpro]
command = "npx"
args = ["-y", "@cutpro/mcp@latest"]
env = { "CUTPRO_API_KEY" = "<your-api-key>" }

https://mcp.cut.pro

claude plugin marketplace add getcutpro/mcp
claude plugin install cutpro@cutpro

更新

每种安装方式都会自动保持最新：

• 托管服务（https://mcp.cut.pro、Claude 插件和 ChatGPT 应用）：始终使用最新版本，无需操作。
• 本地安装（npx -y @cutpro/mcp@latest）：启动时，服务会检查 npm；如果有更新版本，就会将当前会话交由该版本运行。即使使用固定版本或过期的 npx 缓存，此机制也有效。设置 CUTPRO_MCP_AUTO_UPDATE=0 可停留在已安装的版本；此时服务会告知模型有可用更新。
• 工具：新的 API 端点会在十分钟内以工具形式显示，无需发布新版本。

每个版本及其说明都列在 Releases 和 CHANGELOG.md 中。

配置

服务器通过环境变量进行配置。

MCP_TRANSPORT=http PORT=8787 MCP_OAUTH=1 \
MCP_PUBLIC_URL=https://mcp.cut.pro MCP_REDIS_URL=redis://127.0.0.1:6379 \
npx -y @cutpro/mcp@latest

工具

这些工具由 API 自带的 OpenAPI 规范（/api/v1/openapi.json）构建，因此始终与 API 参考保持一致：每个端点对应一个工具，工具名取自其 operationId 并采用蛇形命名法（analyzeVideo 对应 analyze_video，createSubmission 对应 create_submission），并使用端点自身的参数、描述和响应。新端点接入 API 后十分钟内就会成为工具，无需发布此软件包的新版本。

常见工作流：

• 图像或视频：list_generation_models、使用商定价格调用 create_generation，然后调用 get_generation 直到生成结果就绪。将就绪图像的 output.image_id 传入以制作动画。
• 角色形象：get_persona_catalog、create_persona、调用 get_persona 直到其照片就绪、save_persona，然后调用 quote_persona_swap 和 create_persona_video 将其放入视频中。
• 片段：analyze_video、create_submission、调用 get_submission 直到完成、list_clips、render_clip、get_render 和 download_render。

注释也来自规范：GET 为只读，PUT、PATCH 和 DELETE 具有破坏性，路由还会通过其 x-mcp 扩展声明更多信息（消耗积分、发布到社交网络、访问任意公共 URL）。需要从磁盘上传文件的路由仅由本地（stdio）服务器列出，因为聊天客户端无法发送字节数据。

所有工具

90 个工具和 5 个提示词，由实时 API 规范和服务器生成。

提示词

客户端提供的现成请求，可作为快捷方式使用（Claude 中的 / 菜单）。

工作区

余额

视频

提交

片段

渲染

连接

监控

帖子

模板

转录

人设

生成

链接

• 文档：cut.pro/docs/api-reference/mcp
• npm：@cutpro/mcp
• MCP 注册表：io.github.getcutpro/cutpro
• 版本发布：github.com/getcutpro/mcp/releases · CHANGELOG.md
• 贡献：CONTRIBUTING.md · 安全：SECURITY.md · 行为准则

许可证

MIT