Docs

接入文档

Talkcut 说剪是一个标准 MCP 服务。把下面的配置复制进你的客户端，把 tk_live_示例密钥 替换成控制台里生成的密钥即可。云端和本地都要填这把密钥。

快速开始

云端版无需安装，适合直接出成片；需要导出剪映草稿时，请使用本地版。云端地址是 Streamable HTTP，路径为 /mcp。

获取 API 密钥

用邮箱注册并设置密码，或用密码、验证码登录后，在控制台生成密钥。完整密钥只显示一次。重置后旧密钥立即失效。

WorkBuddy

打开「连接器」→「添加自定义 MCP」，填写服务地址和密钥。

{
  "name": "talkcut",
  "url": "http://127.0.0.1:8640/mcp",
  "headers": { "Authorization": "Bearer tk_live_示例密钥" }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "talkcut": {
      "url": "http://127.0.0.1:8640/mcp",
      "headers": { "Authorization": "Bearer tk_live_示例密钥" }
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "talkcut": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:8640/mcp",
               "--header", "Authorization: Bearer tk_live_示例密钥"]
    }
  }
}

本地版（剪映草稿）

本地版在你的电脑上运行，视频不出本机，可直接写入剪映草稿目录。启动时会联网校验密钥；校验结果缓存 1 小时，断网后 72 小时宽限期内仍可使用。

# 安装
pip install -e .

# 环境变量
TALKCUT_API_KEY=tk_live_示例密钥
TALKCUT_API_BASE=http://127.0.0.1:8640

# 客户端配置
{
  "mcpServers": {
    "talkcut-local": {
      "command": "talkcut-mcp",
      "env": {
        "TALKCUT_API_KEY": "tk_live_示例密钥",
        "TALKCUT_API_BASE": "http://127.0.0.1:8640"
      }
    }
  }
}

剪映草稿目录：Mac 为 ~/Movies/JianyingPro/User Data/Projects/com.lveditor.draft，Windows 为 %LOCALAPPDATA%\JianyingPro\User Data\Projects\com.lveditor.draft。探测失败时用 draft_dir 手动指定。草稿由 pyJianYingDraft 0.3.0 生成，对应剪映专业版 5.9。

工具列表

工具	说明
quick_edit	一键完成：识别、去停顿、去口头禅、去重复、加字幕、出成片
transcribe	中文语音识别，输出带时间轴的文本
analyze_cuts	生成剪辑方案 edit_plan.json
update_plan	按片段 id 保留或删除
make_clips	切成多条 9:16 竖屏片段
render_video	按剪辑方案导出 MP4 和 SRT
export_jianying_draft	导出剪映草稿（仅本地版）
get_task_status	查询任务状态、进度和错误

常见问题

不带密钥、密钥无效或已重置时，云端返回 401。额度用完会拒绝本次处理并说明剩余分钟。请求过快返回 429。本地版上报的是工具调用次数，channel 为 local，不扣 120 分钟额度。

识别任务在服务器上一次只跑一个，适合 4 核 4G、没有 GPU 的机器。默认识别引擎是 SenseVoice。