Cuecaps

cuecaps-mcp

在 Claude Code、Cursor、Claude Desktop 或任何 MCP 客户端中，为电脑上的视频或音频文件添加字幕。只需说“为 talk.mp4 添加 Karaoke 字幕，并给我 MP4”，talk.captions.mp4 就会生成在原文件旁边。此服务会在你电脑上的无头 Chrome 或 Edge 中驱动 Cuecaps 工作室自身的导出功能，因此结果与使用相同设置从工作室导出的结果一致。项目同步到你的帐户后，caption_video 还会返回一个工作室链接，打开后即可修正某个词或更改样式。

无需安装：托管服务

可通过 URL 连接 MCP 服务的应用可以使用 https://cuecaps.com/mcp（Streamable HTTP），无需安装或密钥：claude.ai、手机和桌面上的 Claude 应用、ChatGPT、Gemini CLI、Claude Code 和 Cursor。它提供 list_styles 和 studio_link，因此你可以像描述字幕效果那样提出需求（“西班牙语 TikTok 的卡拉 OK 字幕”），然后获取一个已设置好字幕的工作室链接，在浏览器中完成后续操作。要直接为电脑上的文件添加字幕，请使用此软件包（见下文）。

• claude.ai：依次选择 Settings、Connectors、Add custom connector，然后粘贴 https://cuecaps.com/mcp。
• Claude Code：claude mcp add --transport http cuecaps https://cuecaps.com/mcp
• Gemini CLI：在 ~/.gemini/settings.json 中添加 { "mcpServers": { "cuecaps": { "httpUrl": "https://cuecaps.com/mcp" } } }

各客户端的设置方法：cuecaps.com/ai-assistants。

要求

• Node 22 或更高版本。
• Google Chrome 或 Microsoft Edge，且安装在标准路径下。CUECAPS_CHROME 可指向其他浏览器。
• 从 cuecaps.com/account 获取密钥。Creator 或 Pro 套餐包含 Agent 访问权限： cuecaps.com/pricing。

设置

Claude Code

claude mcp add cuecaps --env CUECAPS_API_KEY=cck_… -- npx -y cuecaps-mcp

Claude Desktop 和 Cursor

将以下内容添加到 MCP 配置中：在 Claude Desktop 中依次选择 Settings、Developer、Edit Config，或在 Cursor 中编辑 ~/.cursor/mcp.json。

{ "mcpServers": { "cuecaps": { "command": "npx", "args": ["-y", "cuecaps-mcp"], "env": { "CUECAPS_API_KEY": "cck_…" } } } }

cuecaps.com/account 上的 Agent access 卡片可创建密钥，并显示已填入密钥的此配置。

工具

工具	密钥	功能
list_styles	否	10 种字幕样式：ID、名称及每种样式的外观。
studio_link	否	打开后会应用你的设置的工作室链接。所有套餐均可使用。
account_status	是	你的套餐、本计费周期剩余的云端分钟数、分钟数重置日期，以及套餐是否包含 Agent 字幕功能。
transcribe	是	文件中的每个词及其以秒为单位的开始和结束时间，以及 SRT 文本。不写入任何文件。
caption_video	是	为文件添加字幕，并将结果写入其旁边。

除 path 外，所有输入均为可选项。字幕设置使用与工作室链接相同的名称：style、words（1 到 10）、lines（1 或 2）、position（top、middle、bottom）、aspect（9:16、1:1、4:5、16:9）和 lang（例如 es 这样的语言代码；auto 会让云端转录功能检测语言）。每个工具的架构都列出了有效值。

transcribe 和 caption_video 还接受：

• engine：cloud 使用套餐的云端分钟数，通过 ElevenLabs Scribe 进行转录，尤其擅长处理音乐、口音和 90 多种语言；当剩余分钟数足以处理该文件时，这是默认选项。device 使用设备上的 Whisper，不消耗分钟数；首次运行时会下载模型（132 MB）。结果会注明使用的引擎。
• keyterms：最多可提供 100 个名称和词语，供云端转录功能按你指定的拼写转录。

caption_video 还接受：

• output：mp4 会将字幕直接嵌入视频（默认值）；mov 或 webm 会生成仅含字幕的透明叠加层；srt 或 vtt 会生成字幕文件。
• resolution：720p、1080p（默认值）、1440p 或 4k。Pro 套餐可使用 1440p 和 4K。
• fps：24、25、30（默认值）、50 或 60。
• out_path：指定一个现有文件夹中的绝对路径，将结果写入该路径；输出格式由文件扩展名决定。

示例

list_styles

{}

返回 [{ "id": "bold", "name": "Bold", "look": "Montserrat in capitals with a black outline, …" }, …]。

studio_link

{ "style": "karaoke", "words": 4, "aspect": "9:16" }

返回 { "url": "https://cuecaps.com/studio?style=karaoke&words=4&aspect=9%3A16" }。

account_status

{}

返回 { "plan": "creator", "minutes_left": 287.5, "resets": "2026-11-20", "agents": true }。

transcribe

{ "path": "/Users/ana/clips/talk.mp4", "engine": "device" }

返回 { "words": [{ "text": "Greetings!", "start": 0.48, "end": 1.84 }, …], "srt": "1\n00:00:00,480 --> …", "engine": "device", "minutes_used": 0 }。

caption_video

{ "path": "/Users/ana/clips/talk.mp4", "style": "karaoke", "aspect": "9:16" }

返回 { "file": "/Users/ana/clips/talk.captions.mp4", "duration": 17.17, "engine": "cloud", "minutes_used": 0.29, "studio_url": "https://cuecaps.com/studio#p=…" }。 运行期间，服务会报告进度：Opening、Transcribing、Rendering 42%、Saving。

输出文件

caption_video 会在输入文件所在目录写入 <name>.captions.<ext>。如果文件已存在，则不会覆盖：下一次运行会写入 <name>.captions-2.<ext>，之后依次使用 -3 等。out_path 也遵循相同规则。

studio_url 中的 Studio 链接会在 Creator 和 Pro 套餐上打开已保存的项目。视频文件仍保留在你的设备上，因此你在其他设备上打开该链接时，Studio 会再次要求提供文件。

设置

变量	用途
CUECAPS_API_KEY	你的密钥（cck_ 加 32 个字符）。
CUECAPS_CHROME	Chrome 或 Edge 可执行文件的路径（当其不在标准安装路径时）。
CUECAPS_URL	Cuecaps 网站，默认为 https://cuecaps.com。

隐私

• 视频始终保留在你的设备上。渲染在你电脑上的浏览器中进行。
• 云端转录会像 Studio 一样发送压缩后的语音音频，并在转录后将其删除。engine: "device" 不会发送任何音频。项目及其文字仍会同步到你的账户，正如 Creator 和 Pro 套餐上的每个项目一样。
• 你的密钥只会用于向 cuecaps.com/api/* 发送请求。它绝不会出现在 URL、日志或文件中。
• 每次运行都会使用临时浏览器配置文件，并在之后将其删除，因此不会留下 Cookie 或项目。

许可证

MIT。源代码位于 github.com/Pantheonn3D/cuecaps-mcp。