Skip to main content
Glama

Pavo 官网 MCP

独立操作 Pavo 官网账号的本地 stdio MCP 服务。当前版本 0.3.1,共 57 个工具,涵盖画布、参考素材、生成任务、结果下载、官网资产,以及独立 AI 剧本、分镜编辑和角色/场景/道具资料管理。

客户端直接实现官网 API,不依赖 PAVO CLI,也不使用 Agnes API Key。本项目是独立客户端,不由 Pavo 官方运营;官网接口可能变化,不能把本地测试通过当作所有生产业务已验证。

功能与边界

范围

已实现

画布

项目、节点、中文提示词、模型配置、参考连接、首尾帧和多图模板、批量预览及应用

媒体与生成

上传图片/视频/音频、画布任务与结果下载;原生短剧片段媒体关联、选择、视频提交及状态查询

官网资产

将已有节点资源保存到“我的资产”,查询图片/视频资产和历史产物

AI 剧本

剧情文本/文件交由 Pavo 生成分集、大纲/人物小传/分集编辑、角色场景道具提取、分镜及导出

手动剧本资产

新增、改名、增加或编辑状态描述,设置参考图、形象主图与可编辑的分集绑定

分镜编辑

镜头文字、场景素材标签、单镜时长、本项目素材引用;按需新增片段/镜头、删除已迁移旧镜,回读保护既有媒体

恢复保护

本地操作台账、同号复用、UNKNOWN 防重投、账号归属校验、原子下载

剧本内角色图、三视图、音色、场景图和道具图生成,以及删除项目/资产/媒体、订阅购买等功能没有接入。分镜整理提供受控删镜及迁移后的旧片段删除,保护既有媒体;不提供通用强删或媒体删除。画布生成工具不等于这些剧本内媒体接口。

Related MCP server: Axcel MCP

环境与安装

支持 macOS、Linux,Python 3.12 及以上。跨进程锁使用 POSIX fcntl,暂不支持原生 Windows。先安装 Git 和 uv,然后执行:

git clone https://github.com/congliu1851-ui/pavo-website-mcp.git
cd pavo-website-mcp
uv sync --frozen --all-groups

项目自带依赖锁,不需要修改其他 Python 项目的环境。没有安装 uv 时,也可自行创建虚拟环境后执行 python -m pip install .;开发和持续集成使用锁文件安装。

接入 Codex

在克隆目录执行:

codex mcp add pavo-website -- "$(pwd)/.venv/bin/python" -m pavo_website_mcp.server

其他 MCP 客户端使用以下配置,替换成自己机器的绝对路径:

[mcp_servers.pavo-website]
command = "/ABSOLUTE/PATH/pavo-website-mcp/.venv/bin/python"
args = ["-m", "pavo_website_mcp.server"]

配置示例另见 codex-mcp.example.toml。本服务不监听 HTTP 端口,stdout 只承载 MCP 协议。更新源码后,需重新连接 MCP,调用 pavo_server_status 核对运行版本;配置启用不等于当前会话已加载最新版。

登录认证

需要用户有权使用的官网 Authorization: Bearer …。推荐在本机终端输入,输入不会回显:

.venv/bin/python -m pavo_website_mcp.login

macOS 也可以运行 登录Pavo.command。工具 pavo_auth_import_authorization 同样可导入用户明确提供的凭证,但工具输入可能留在客户端会话记录中,因此优先使用本机终端。

导入会先通过官网只读接口验证,失败不替换原会话。凭证和台账默认存于 ~/.local/share/pavo-website-mcp,目录权限0700、会话与数据库0600;也可通过 PAVO_STATE_DIR 指定自己的私有目录。不要将该目录、Token、Cookie 或真实回执提交到仓库。

导入新账号影响后续新操作;已经开始的写操作固定使用开始时的账号认证,防止执行途中换号导致请求和台账归属不一致。JWT 到期时间只是未验证的本地提示,官网响应才是认证依据。

快速使用

画布生成

  1. 读取 pavo_server_status、pavo_list_projects 和实时 pavo_list_models。

  2. 创建项目,上传素材,保存真实项目/画布/节点 ID 和稳定素材地址。

  3. 创建生成节点并填写模型、提示词和参数。首尾帧使用实时官网 guide 模板,不猜输入键名。

  4. 预览批量修改,再执行 pavo_validate_canvas。预览只构造变更计划,不代替最终提交前的模型及参考输入校验。

  5. 用户确定本次模型、参数和费用范围后,调用 pavo_submit_task,保存原生 task_id。

  6. 查询任务,成功后分别回写、下载或保存官网资产。回写失败只重试回写,下载失败只恢复下载。

实时校验包括模型可用性、画幅、分辨率、时长,以及官网明确提供的参考类型、每类参考节点数和总数上限。文件本身的时长、分辨率、格式和人物对白质量仍需对应检查,不能凭“支持音频”推断支持准确台词或口型。

剧情交给 Pavo 分集

文本直接调用 pavo_script_import_text;文件先调用 pavo_script_upload_file,再将上传操作号交给 pavo_script_import_file。两个提交入口都使用官网 projects/ai-generate,将原剧情作为 requirements,由 Pavo 分配每集情节。

必须提供 planned_episode_count,范围1至100;官网当前接口不支持省略后自动决定总集数。AI 可能改写、扩写剧情,不是逐字导入。生成大纲后先读取真实进度,待确认时单独调用 confirm_outline,不会自动连续触发后续任务。

TXT 要求 UTF-8,支持 BOM;DOCX 必须为真实文档。文件32MiB、解压64MiB上限,原文连同标题与生成说明最多100000个UTF-16单位,超限拒绝且不截断。文件提交会核上传回执对应的本地原文件 SHA,因此原文件须仍存在且未修改。

操作回执与费用

所有写操作使用稳定的 operation_id。同号相同输入复用回执,同号不同输入或账号会拒绝。

状态

含义

SUCCESS

请求回执已保存;生成提交成功不等于生成完成

FAILED

明确的输入错误或官网拒绝;修正后再判断是否可用新操作号

RUNNING / UNKNOWN

执行中或结果未知;禁止换号重新提交,先查本地回执和官网真实状态

服务不会自动重投未知的收费请求,也不承诺官网没有提供的全局“只执行一次”。UNKNOWN 没有强行清空或跳过保护的工具,需要核对真实回执。模型价格、免费状态与账号权限均以调用时官网数据为准,剧本生成和解析不能默认免费。

文档

验证与许可

uv run --frozen pytest -q
uv build

测试使用模拟官网响应、临时状态目录和真实 stdio 进程,不需要登录或消耗账号额度。发布前做过官网只读联调及专用测试画布的非生成联调;收费生成和所有剧本写入没有完整生产验收,具体边界见开发说明。

提供macOS/Linux GitHub Actions模板。本次推送凭证不含workflow权限,因此模板未放入.github/workflows/,自动CI尚未启用,也没有GitHub Actions通过记录。仓库维护者取得相应权限后,可将模板复制到.github/workflows/test.yml再提交启用。

公开仓库不包含个人会话、生产回执、官方演示正文、下载的第三方官网脚本或本机路径。项目代码采用 MIT 许可证,不对外部平台、模型或用户素材授予额外权利。

Available Tools

57 tools
pavo_apply_canvas批量搭建画布A
Idempotent

批量create/update/connect,默认只预览。create含type、可选as别名/name/prompt/model/params/media_type/url;update含node_key和待改字段;connect含source/target/role/media_order,使用$name引用此前创建的别名。dry_run=false才写入。

Inputs: operations (required), canvas_uuid (required), operation_id (required), project_uuid (required), +1 more. Returns: object

pavo_apply_template按实时模板绑定首尾帧B
Idempotent

按官网guide构建首尾帧等多输入模板。inputs={官网实际输入node_key:已有素材node_key},所有输入必须明确绑定,不使用模板示例素材。保留技能、原生连接和顺序,返回run_node_key;仅搭图,不生成。

Inputs: code (required), inputs (required), canvas_uuid (required), operation_id (required), +4 more. Returns: object

pavo_auth_import_authorization导入官网Bearer认证A

仅接收用户明确提供的Authorization: Bearer值,通过官网只读项目接口核验后保存在本机0600会话文件;不回显凭证。禁止把凭证写到源码、配置示例或日志。

Inputs: authorization (required). Returns: object

pavo_connect_references连接参考素材A
Idempotent

为节点添加有序图片/视频/音频参考。references每项含source=node_key、可选role=reference或prompt、media_order及原生handle/port。首尾帧必须用apply_template。不会替换已有连接。

Inputs: references (required), canvas_uuid (required), operation_id (required), project_uuid (required), +2 more. Returns: object

pavo_create_node创建画布节点A
Idempotent

创建text/image/video/audio/upload节点;upload使用上传返回的url和media_type。模型code从实时列表选择,params含duration/count/settings。dry_run仅预览,不写官网。

Inputs: node_type (required), canvas_uuid (required), operation_id (required), project_uuid (required), +9 more. Returns: object

pavo_create_project创建官网项目B
Idempotent

创建新项目;operation_id必须稳定,相同操作号相同输入返回已有真实回执。

Inputs: title (required), operation_id (required), cover_url. Returns: object

pavo_download_task_results下载真实生成结果A
Idempotent

从原生成功任务的真实结果下载至绝对目录,逐项返回路径、字节数和SHA。复用经回执核SHA的已有文件,不覆盖其他文件;失败只重试下载,不重新生成。

Inputs: task_id (required), output_dir (required). Returns: object

pavo_get_model读取模型约束B
Read-onlyIdempotent

读取指定实时model_code的账号可用性、分辨率、画幅、时长、输入模式等约束。

Inputs: model_code (required), scene_code (required). Returns: object

pavo_get_node读取指定节点C
Read-onlyIdempotent

按真实node_key读取节点,并解析字符串或对象形式的data。

Inputs: node_key (required), canvas_uuid (required), project_uuid (required). Returns: object

pavo_get_operation读取本地操作回执B
Read-onlyIdempotent

查询本地持久化回执:SUCCESS为写请求回执成功,FAILED为明确拒绝,RUNNING/UNKNOWN不得重投。生成提交SUCCESS不等于任务已生成成功。

Inputs: operation_id (required). Returns: object

pavo_get_project读取项目画布B
Read-onlyIdempotent

显式读取项目和画布,返回原生节点、连接、最新version和官网链接。

Inputs: canvas_uuid (required), project_uuid (required). Returns: object

pavo_get_task查询生成进度A
Read-onlyIdempotent

按真实任务ID查询原生进度;found=false表示历史暂缺,不能据此重新生成。succeeded依据原生状态,不根据URL猜成功。

Inputs: task_id (required). Returns: object

pavo_get_tool_specs读取官网实时模板A
Read-onlyIdempotent

不传code返回完整官网tool-specs;传code返回指定模板。guide.extra.node_list中action_type=input的node_key就是真实输入键,不能猜first/last。

Inputs: code. Returns: object

pavo_list_artifacts读取项目历史产物A
Read-onlyIdempotent

读取项目历史真实产物。category=all/images/videos;该接口按日期分组分页,total不是文件总数。

Inputs: canvas_uuid (required), project_uuid (required), page, category, +1 more. Returns: object

pavo_list_assets读取账号资产B
Read-onlyIdempotent

分页读取账号images或videos资产,保留服务端分页结构。

Inputs: page, category, page_size. Returns: object

pavo_list_connections读取参考连接B
Read-onlyIdempotent

读取权威connection_list,保留role、端口、media_order;不以节点data.source猜依赖。

Inputs: canvas_uuid (required), project_uuid (required). Returns: object

pavo_list_models查询实时模型A
Read-onlyIdempotent

读取账号实时canvas_image、canvas_video或canvas_audio模型列表与约束;文字模型由tool-specs返回。

Inputs: scene_code (required). Returns: object

pavo_list_nodes读取画布节点B
Read-onlyIdempotent

读取画布全部节点,节点data保留官网原始结构。

Inputs: canvas_uuid (required), project_uuid (required). Returns: object

pavo_list_projects读取项目列表B
Read-onlyIdempotent

读取当前官网登录账号的项目列表。

Inputs: no named parameters. Returns: object

pavo_save_node_asset保存节点资源到官网资产A
Idempotent

把节点指定的真实媒体资源保存到官网我的资产。上传资产链路为上传媒体、创建upload节点、保存节点资产。

Inputs: node_key (required), canvas_uuid (required), operation_id (required), project_uuid (required), +2 more. Returns: object

pavo_script_attach_segment_media关联已上传媒体到片段A
Idempotent

将已上传HTTPS图片/视频沿原生media/upload存历史,再select并回读槽位;image用segment_keyframe,video用segment_video且须明确first_frame_url。核最新media指纹,保护脚本文字和其它媒体。不生图、不生成视频;部分成功保持UNKNOWN,禁止换号重投。

Inputs: url (required), episode_id (required), media_type (required), project_id (required), +5 more. Returns: object

pavo_script_create_aiAI创作剧本A
Idempotent

调用官网AI剧本生成,可能消耗额度,需用户授权本次创作与费用。计划1至100集、画幅9:16或16:9,style使用实时style_id或custom_style_prompt。只提交一次并返回真实project_id/task_ids,不自动确认大纲或启动后续媒体。

Inputs: ratio (required), style (required), operation_id (required), requirements (required), +1 more. Returns: object

pavo_script_create_asset手动新增角色场景道具A
Idempotent

手动新增character角色、scene场景或prop道具及初始状态描述。按原生name/title字段保存,返回真实asset_id/state_id,不生成图片、不自动同步到后续制作。官网只读演示拒绝写入。

Inputs: name (required), asset_type (required), project_id (required), operation_id (required), +2 more. Returns: object

pavo_script_create_storyboard_segment新增分镜片段A
Idempotent

沿官网POST episodes/{id}/segments,仅新增指定排序的片段,不复制或删除原镜头。须最新storyboard指纹,回读返回新增对象、官网默认场景镜头及新指纹;保护既有顺序和媒体。不自动生成。拆段应先复制保存并核验,再明确删除已迁移旧镜。

Inputs: episode_id (required), project_id (required), operation_id (required), display_order (required), +1 more. Returns: object

pavo_script_create_storyboard_shot新增片段内分镜镜头A
Idempotent

核本项目分集片段归属及最新storyboard指纹,按官网POST segments/{id}/shots新增镜头。返回完整回读及新指纹,不自动填正文、不移动旧镜、不生成媒体。

Inputs: episode_id (required), project_id (required), segment_id (required), operation_id (required), +2 more. Returns: object

pavo_script_delete_storyboard_segment删除已迁移且无媒体的旧片段A
DestructiveIdempotent

仅用于明确授权的分镜迁移:先完整保存并人工核完替代段台词/动作,再删除无任何已选及历史媒体的旧AI草稿段。须同集真实非空replacement_segment_ids、最新storyboard指纹、绝对backup_dir;工具先备份整集,再按官网DELETE segments/{id}删除并回读目标消失、替代及其它正文/媒体/顺序保留。不是删除最后一镜的兜底,不删除剧本/资产;UNKNOWN禁止新号重投。

Inputs: backup_dir (required), episode_id (required), project_id (required), segment_id (required), +3 more. Returns: object

pavo_script_delete_storyboard_shot删除已迁移分镜镜头A
DestructiveIdempotent

明确删除指定镜头,只用于已授权的分镜整理;拆段先完成新段复制保存与核验,再调用本工具。核最新storyboard指纹及归属,禁止删除该场景最后一镜,保留其它内容、排序相对关系和原段媒体,不删除片段或媒体;UNKNOWN禁止换号重投。

Inputs: shot_id (required), episode_id (required), project_id (required), operation_id (required), +1 more. Returns: object

pavo_script_export导出剧本和分镜到本地A
Idempotent

读取原生剧本内容后导出到绝对目录,支持json/markdown/doc。doc为与官网同类的Word兼容HTML,不冒称DOCX。可附原生分镜数据,返回SHA和状态;不会触发生成、视频导出或覆盖不同内容的文件。

Inputs: output_dir (required), project_id (required), format, include_storyboards. Returns: object

pavo_script_get_assets读取剧本角色场景道具A
Read-onlyIdempotent

读取characters/scenes/props与各状态,额外返回_mcp_fingerprints用于手动编辑前核对;不重新提取或生成图片。

Inputs: project_id (required). Returns: object

pavo_script_get_episode读取剧本指定分集A
Read-onlyIdempotent

核对项目归属后读取指定集的原生正文和状态,不能跨项目误用分集ID。

Inputs: episode_id (required), project_id (required). Returns: object

pavo_script_get_project读取剧本内容和进度A
Read-onlyIdempotent

读取剧本原生状态、active_tasks、任务ID、大纲和分集。返回outline及episodes指纹,编辑前必须核对;无任务不代表未知提交未发生。include_content=false的结果不能用来覆盖完整正文。

Inputs: project_id (required), include_content. Returns: object

pavo_script_get_segment_media读取片段媒体和状态B
Read-onlyIdempotent

核原生制作分集及片段归属,读取关键帧/视频历史、原生任务状态及选中槽位,返回_mcp_fingerprints.media。关键帧为segment级,一段多镜仍只有该段槽位。

Inputs: episode_id (required), project_id (required), segment_id (required). Returns: object

pavo_script_get_segment_video_task查询短剧片段视频任务A
Read-onlyIdempotent

从本片段原生segment_video历史匹配generation_task_id查询状态,不调用画布get_task。仅已核success/failed作终态判断;未知状态、历史暂缺、运行超5分钟都不能自动重提。失败重试另用明确授权的提交工具。

Inputs: task_id (required), episode_id (required), project_id (required), segment_id (required). Returns: object

pavo_script_get_storyboard读取剧本分集分镜A
Read-onlyIdempotent

核项目归属后读取原生段落、场景、镜头及active_tasks,附_mcp_fingerprints.storyboard和各实体指纹供编辑。生成分镜需单独调用run_stage,不会自动制作图片或视频。

Inputs: episode_id (required), project_id (required). Returns: object

pavo_script_import_file从上传剧情由Pavo生成分集A
Idempotent

使用本账号成功上传回执,核本地源文件SHA并提取剧情,以requirements调用官网AI生成分集,不再调用projects/upload完整剧本解析。兼容原上传回执,但源文件须仍存在且未改;不下载任意URL或重新上传。计划集数1至100;可能消耗额度,需本次生成授权,不自动确认大纲。

Inputs: ratio (required), style (required), operation_id (required), upload_operation_id (required), +1 more. Returns: object

pavo_script_import_text提交剧情由Pavo生成分集A
Idempotent

把未分集的剧情作为requirements交给官网AI生成剧本,由Pavo安排每集内容,不再走完整剧本paste解析。planned_episode_count为用户指定的1至100集,官网接口不支持省略;连同标题及分集说明最多100000个UTF-16单位,不截断原文。可能消耗额度,需本次生成授权;只返回真实创建回执,不自动确认大纲或启动媒体。

Inputs: ratio (required), style (required), title (required), raw_text (required), +2 more. Returns: object

pavo_script_list_media_models读取短剧媒体实时模型A
Read-onlyIdempotent

按官网model_options查询segment_keyframe或segment_video模型与账号约束;不混用canvas类别,不生成。

Inputs: scene_code (required). Returns: object

pavo_script_list_projects读取AI剧本项目A
Read-onlyIdempotent

分页查询官网/playlet/list剧本项目。is_demo=true读取官方只读演示,不可修改。

Inputs: page, is_demo, page_size. Returns: object

pavo_script_list_storyboard_episodes读取原生制作分集列表A
Read-onlyIdempotent

读取官网projects/{id}/episodes/storyboard制作分集,不把progress中的剧本草稿分集ID猜作制作分集ID。只读,不生成。

Inputs: project_id (required). Returns: object

pavo_script_list_styles读取剧本风格库A
Read-onlyIdempotent

读取独立AI剧本创作入口的实时风格库;使用真实style_id,不把画布模板或模型code当风格ID。

Inputs: no named parameters. Returns: object

pavo_script_rename_asset重命名角色场景道具A
Idempotent

核本项目、本类型资产及get_assets返回的asset指纹后,只修改角色name或场景/道具title,不改状态描述、图片或绑定。

Inputs: name (required), asset_id (required), asset_type (required), project_id (required), +2 more. Returns: object

pavo_script_run_stage执行指定剧本阶段A
Idempotent

可能消耗额度,需用户明确授权本阶段。stage支持confirm_outline/extract_assets/finalize_assets/generate_episode/generate_storyboard/resume_episodes/retry_outline/retry_episodes。finalize_assets显式同步资产(is_manual=true),不与手动保存捆绑;可能推进后续阶段。generate_episode和generate_storyboard必须提供归属正确的episode_id。复核只读、原生状态及运行任务;UNKNOWN不得换号重投。不是视频、关键帧或合成接口。

Inputs: stage (required), project_id (required), operation_id (required), episode_id, +1 more. Returns: object

pavo_script_save_asset_state新增或编辑角色场景道具状态A
Idempotent

不传state_id时新增状态,须省略expected_sha256,patch须含state_name和description;编辑已有状态须传真实state_id及对应states指纹。可改state_name/description/episode_nos/reference_images,参考图使用已上传的HTTPS公网地址。完整保留未改的图片、模型、样式与可编辑绑定,按原生POST states upsert保存;不会发起图片生成。

Inputs: patch (required), asset_id (required), asset_type (required), project_id (required), +3 more. Returns: object

pavo_script_select_segment_media选择片段已有媒体B
Idempotent

只选择该片段原生历史中的唯一media_id,核最新media指纹并回读目标槽位;禁止运行中或失败记录,保留另一槽位和所有原媒体、正文。不生成。

Inputs: media_id (required), episode_id (required), project_id (required), segment_id (required), +2 more. Returns: object

pavo_script_set_asset_main_image设置角色场景道具形象主图A
Idempotent

将已上传的HTTPS图片设为指定状态的形象主图main_image。asset_type为character/scene/prop;须传get_assets对应states指纹与真实像素宽高,比例自动计算,thumbnail_url省略时使用原图。核归属、只读、同名状态歧义及UNKNOWN,按官网art-versions(sync_to_entity=true)保存版本并回读主图;不会触发生成。参考图使用save_asset_state;设置形象图片使用本工具。官网无CAS,避免同时在网页编辑同一状态。

Inputs: width (required), height (required), asset_id (required), state_id (required), +6 more. Returns: object

pavo_script_set_character_four_view_image设置角色四视图A
Idempotent

将已上传的角色四视图设为指定状态的独立四视图图片位,原生字段为three_view_image。须提供get_assets对应states指纹及真实像素宽高;核归属、只读、同名状态及UNKNOWN,保存原生版本并回读目标图片和原有形象主图,保留描述、参考图、模型及绑定。不发起生成,不自动入素材库;官网无CAS,避免同时在网页编辑同一状态。

Inputs: width (required), height (required), asset_id (required), state_id (required), +5 more. Returns: object

pavo_script_submit_segment_video提交单片段视频B
Idempotent

消耗额度,须用户已授权模型参数和费用。显式模型、分辨率、style_id或custom_style_prompt、expected_ratio;比例只核项目,原生请求无独立ratio字段。核实时segment_video模型和段总时长、已选关键帧;只调用已核single_frame视频合同,保存唯一真实新task_id。不调用Pavo生图。UNKNOWN禁止重投;重生成须regenerate且旧任务为已核终态。

Inputs: style (required), episode_id (required), model_code (required), project_id (required), +7 more. Returns: object

pavo_script_update_episodes编辑和增加剧本分集A
Idempotent

使用get_project完整内容返回的episodes指纹。episodes每项含episode_id及title/content修改;未指定的已有分集保留。new_episodes含episode_no/title/content。只保存,不自动触发资产提取或后续生成。

Inputs: episodes (required), project_id (required), new_episodes (required), operation_id (required), +1 more. Returns: object

pavo_script_update_outline编辑剧本大纲B
Idempotent

根据get_project返回的outline指纹修改指定字段。支持story_type/target_audience/one_line_story/story_summary/world_setting/character_biographies(name,bio),保留其余内容,不自动确认大纲。官网无version CAS,避免同时在网页编辑。

Inputs: patch (required), project_id (required), operation_id (required), expected_sha256 (required). Returns: object

pavo_script_update_storyboard编辑分镜文字和时长A
Idempotent

按get_storyboard的_mcp_fingerprints.storyboard核对后保存,同一次仅编辑一个片段,整集须逐段调用。shots每项含shot_id及content_rich/duration_sec;scenes每项含scene_id/content_rich,内容仅为一个本项目场景标签,细节写镜头正文。单镜时长为1至15整数,素材标签必须属于本项目。沿官网PATCH shots保存并回读文字、时长、素材引用、派生视频提示词;保护原媒体与其余字段。不生成、不付费;UNKNOWN禁止换号重投。

Inputs: shots (required), scenes (required), episode_id (required), project_id (required), +2 more. Returns: object

pavo_script_upload_file上传TXT或DOCX剧本A
Idempotent

准备步骤:上传本地非空UTF-8 TXT或真实DOCX并检查,返回file_url和SHA;文件32MiB、解压64MiB上限,不自动创建剧本。后续用import_file及计划集数交给Pavo AI生成分集;保留本地源文件用于核SHA及读取剧情。不发送Bearer到存储,inspect按用户文件上传授权调用。

Inputs: path (required), operation_id (required). Returns: object

pavo_server_status连接和登录状态A
Read-onlyIdempotent

读取脱敏登录状态,不访问官网、不返回凭证。JWT到期值仅用于本地提示,未做签名认证。

Inputs: no named parameters. Returns: object

pavo_submit_task提交生成任务A
Idempotent

会消耗官网账号额度,仅在用户明确授权模型、参数和费用范围后调用。只提交一次,立即保存真实task_id,不等待生成。UNKNOWN禁止重投。regenerate仅用于用户明确要求再次生成且原任务已终止的情况。

Inputs: node_key (required), canvas_uuid (required), operation_id (required), project_uuid (required), +1 more. Returns: object

pavo_sync_task_result回写任务状态和结果A
Idempotent

从本地已保存的生成提交回执定位准确项目和节点,查询并回写状态或成功产物;禁止覆盖后来修改的参数或其他任务。轮询状态变化后需要新的回写operation_id。

Inputs: operation_id (required), submission_operation_id (required). Returns: object

pavo_update_node更新节点和提示词B
Idempotent

保留未知字段并深合并指定参数。prompt只替换文字片段,保留skill及媒体。版本冲突若同字段已改则拒绝覆盖。

Inputs: node_key (required), canvas_uuid (required), operation_id (required), project_uuid (required), +6 more. Returns: object

pavo_upload_media上传本地媒体A
Idempotent

上传明确指定的本地绝对路径图片、视频或音频,返回稳定public_url和SHA;不会自动创建节点或保存资产。

Inputs: path (required), operation_id (required). Returns: object

pavo_validate_canvas预检画布A
Read-onlyIdempotent

核节点、依赖循环和已选择模型的实时约束;占位节点未选模型列警告。valid只表示已知协议预检,不等于生成或成片成功。

Inputs: canvas_uuid (required), project_uuid (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 57 tools

    Disambiguation3/5

    The set splits into two parallel universes (canvas/graph editing under pavo_* and AI script production under pavo_script_*) that both contain projects, assets, models, and tasks, so pairs like pavo_get_project vs pavo_script_get_project, pavo_list_assets vs pavo_script_get_assets, or pavo_get_task vs pavo_script_get_segment_video_task rely almost entirely on the prefix to disambiguate. Within script, three overlapping creation entry points (create_ai, import_text, import_file, plus upload_file as a preparatory step) create residual ambiguity, though the very detailed descriptions do spell out the intended boundaries.

    Naming Consistency4/5

    Names follow a stable pavo_[script_]verb_noun convention (get_/list_/create_/update_/delete_/submit_/apply_/attach_/select_/save_/set_/download_), which is highly predictable across 57 tools. Minor deviations exist, e.g. pavo_server_status and pavo_auth_import_authorization, and the script_ prefix is a namespace rather than a verb, but overall the pattern is readable.

    Tool Count2/5

    57 tools is far beyond a practical agent-facing surface, even for a genuinely broad product covering canvas graphs plus a full script-to-video pipeline. Many operations are fine-grained (separate tools for creating a storyboard segment vs a shot, setting a main image vs a four-view image), pushing complexity onto the caller rather than consolidating via parameters.

    Completeness4/5

    Coverage of the domain is unusually deep: project/canvas lifecycle, node CRUD, connections, model constraints, templates, validation, task submission/status/sync/download, plus script creation, outline, episodes, assets and their states/images, storyboard segments/shots, media attach/select and video submission. Notable gaps remain around destructive/lifecycle ends: no delete for projects, nodes, connections, or script assets, and no task listing or cancellation tool.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables any MCP-compatible AI agent to generate videos and images from text or reference frames, chain scenes into seamless multi-scene films with sound and speech, and download finished media with manifests and previews. It also exposes account status, plan limits, history and library management through confirm-gated, safe-by-default operations.
      26
      34
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to search, browse, download, organize, and post-process comics through MCP tools, including account login, favorites, comments, rankings, configuration, and download task control. Supports stdio, SSE, and HTTP transports while exposing knowledge resources for configuration and skill reference.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables external AI clients to automate and inspect Pencil2D through MCP, including authenticated sessions, layers, keyframes, strokes, undo/redo, previews, saves, snapshots, and export jobs.
      GPL 2.0