KiVio Creator

@kiviocreatorsmcp/mcp-creator

面向 KiVio 创作者端的 MCP 服务。通过 Claude Code（或任何 Model Context Protocol 客户端）管理你的 KiVio Studio：上传视频、管理系列、回复委托请求、查看收益、申请管理员删除。

KiVio 是一个面向儿童的无广告短篇 AI 卡通平台。创作者直接获得付费家长支付的金币（70/30 分成，不靠广告抽奖）。 这个软件包让你可以通过终端 / AI 编码环境管理创作者端业务，而不必使用网页版控制面板。

---

安装

npm install -g @kiviocreatorsmcp/mcp-creator

验证：

kivio-mcp status
# > Not linked.

关联创作者账号

1. 打开 https://kidsaivideo.com/creator/dashboard 并登录。

2. 滚动到 关联外部工具，点击 生成关联码。

3. 复制代码（格式如 MCP-ABC-234-DEF，有效期为 10 分钟）。

4. 在终端中：

   kivio-mcp link MCP-ABC-234-DEF
   

   预期输出：

   Linked as Astroludo ([email protected]).
   Token saved to /Users/you/.kivio/token.json.
   

此令牌是一个有效期为 90 天的 KiVio 创作者会话。可随时通过 kivio-mcp unlink 取消关联，并在 Studio 中生成新代码来轮换令牌。

接入 Claude Code

添加到 ~/.claude/mcp.json（或项目的 .mcp.json）中：

{
  "mcpServers": {
    "kivio": {
      "command": "kivio-mcp"
    }
  }
}

重启 Claude Code。现在，你可以在任何会话中这样说：

“将 ~/renders/ep3.mp4 中的 mp4 上传为我的 Rocket Baker 系列的第 3 集，标题为‘The Rising Dough’。”

Claude 会调用 kivio.upload_video，随后启动审核流程。 几秒钟内，状态就会显示在 kivio.list_videos 中。

可用工具

工具	功能
kivio.link_account	使用 Studio 提供的一次性代码关联此安装
kivio.whoami	已关联的创作者资料和钱包
kivio.list_series	你的系列
kivio.list_videos	你的上传内容（可按系列或状态筛选）
kivio.get_earnings	可用／待处理／累计收益
kivio.create_series	创建新系列（标题、计划集数和分类标记）
kivio.upload_video	一次调用完成预签名 → PUT 到 S3 → 注册
kivio.replace_video	替换 SAFE_LIVE 视频的文件内容，保留解锁状态
kivio.list_commissions	未结委托（可按状态筛选）
kivio.get_commission	一项委托及最近 20 条聊天消息
kivio.accept_commission	接受提案，从委托方账户扣款，并开始 14 天交付期限
kivio.counter_commission	对报价还价
kivio.reject_commission	拒绝（终止状态）
kivio.deliver_commission	为委托附加视频（视频必须位于 PUBLIC_COMMISSION 或 PRIVATE_COMMISSION 系列中）
kivio.reply_in_thread	私信回复（服务器端会对每条消息运行联系信息过滤器）
kivio.request_video_deletion	提交 SAFE_LIVE 视频以供管理员移除
kivio.get_certificate	为 SAFE_LIVE 视频签发签名的 数字平台来源证明。载荷包含显示名称、已验证邮箱、发布时间戳以及原始上传内容的 SHA-256。可用于其他平台上的 DMCA／在先技术证据。
kivio.update_video	编辑现有视频的标题／seriesId／episodeNumber（SAFE_LIVE 后禁止更换系列；始终允许调整集数顺序，服务器会自动重新计算 coinCost）
kivio.delete_video	删除非上线视频（INTAKE／QUALITY_CHECK／MODERATION／REJECTED）
kivio.update_series	编辑系列标题／描述／releaseDate（创建后锁定 totalEpisodesPlanned、isExclusive、commissionBucket）
kivio.reorder_series	调整公开个人资料中系列的顺序——按显示顺序传入完整 ID 列表
kivio.list_dm_threads	列出与委托方的所有私信会话（按最新优先），并显示未读数
kivio.read_thread	获取一个私信会话中的最新 N 条消息（默认为 20 条）；同时将会话标记为已读
kivio.get_analytics	完整 KPI 数据：平台费用、托管款项、累计总额／待处理／可用／已支付金额、拒付与安全标记计数、付款资格、视频数量
kivio.list_tips	最近收到的 100 笔打赏及总额（已释放与待处理）
kivio.submit_support_ticket	向 KiVio 运营团队提交工单；可选 videoId
kivio.list_support_tickets	你提交的支持工单，按最新优先排序——状态及管理员回复

环境覆盖项

• KIVIO_API_BASE — KiVio API 的基础 URL。默认为 https://api.kidsaivideo.com。可指向本地开发服务器进行 测试。

CLI 命令（MCP 之外）

kivio-mcp link <code>    # link this install to a creator account
kivio-mcp status         # show who's linked
kivio-mcp unlink         # clear the stored token
kivio-mcp                # run the MCP server over stdio (Claude Code invokes this)

安全性

• 令牌存储于 ~/.kivio/token.json，权限模式为 0600。
• 每次工具调用都会使用已存储的 bearer 令牌进行身份验证。
• Web Studio 的 Link external tools 面板会显示每个有效令牌的签发时间戳；如果设备丢失，请在此处撤销令牌。
• 每条私信回复中的联系信息（电子邮件、电话号码、URL、社交账号、即时通讯应用名称）都会在服务器端进行过滤后再存储，不论消息由哪个工具写入。

许可证

UNLICENSED。仅限 KiVio 创作者账户使用。