Pavo 官网 MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PAVO_STATE_DIR | No | Specify your own private directory for storing credentials and the operation ledger (default is ~/.local/share/pavo-website-mcp) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pavo_server_statusA | 读取脱敏登录状态,不访问官网、不返回凭证。JWT到期值仅用于本地提示,未做签名认证。 |
| pavo_auth_import_authorizationA | 仅接收用户明确提供的Authorization: Bearer值,通过官网只读项目接口核验后保存在本机0600会话文件;不回显凭证。禁止把凭证写到源码、配置示例或日志。 |
| pavo_list_projectsB | 读取当前官网登录账号的项目列表。 |
| pavo_create_projectB | 创建新项目;operation_id必须稳定,相同操作号相同输入返回已有真实回执。 |
| pavo_get_projectB | 显式读取项目和画布,返回原生节点、连接、最新version和官网链接。 |
| pavo_upload_mediaA | 上传明确指定的本地绝对路径图片、视频或音频,返回稳定public_url和SHA;不会自动创建节点或保存资产。 |
| pavo_list_nodesB | 读取画布全部节点,节点data保留官网原始结构。 |
| pavo_get_nodeC | 按真实node_key读取节点,并解析字符串或对象形式的data。 |
| pavo_create_nodeA | 创建text/image/video/audio/upload节点;upload使用上传返回的url和media_type。模型code从实时列表选择,params含duration/count/settings。dry_run仅预览,不写官网。 |
| pavo_update_nodeB | 保留未知字段并深合并指定参数。prompt只替换文字片段,保留skill及媒体。版本冲突若同字段已改则拒绝覆盖。 |
| pavo_list_modelsA | 读取账号实时canvas_image、canvas_video或canvas_audio模型列表与约束;文字模型由tool-specs返回。 |
| pavo_get_modelB | 读取指定实时model_code的账号可用性、分辨率、画幅、时长、输入模式等约束。 |
| pavo_get_tool_specsA | 不传code返回完整官网tool-specs;传code返回指定模板。guide.extra.node_list中action_type=input的node_key就是真实输入键,不能猜first/last。 |
| pavo_connect_referencesA | 为节点添加有序图片/视频/音频参考。references每项含source=node_key、可选role=reference或prompt、media_order及原生handle/port。首尾帧必须用apply_template。不会替换已有连接。 |
| pavo_list_connectionsB | 读取权威connection_list,保留role、端口、media_order;不以节点data.source猜依赖。 |
| pavo_validate_canvasA | 核节点、依赖循环和已选择模型的实时约束;占位节点未选模型列警告。valid只表示已知协议预检,不等于生成或成片成功。 |
| pavo_apply_canvasA | 批量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才写入。 |
| pavo_apply_templateB | 按官网guide构建首尾帧等多输入模板。inputs={官网实际输入node_key:已有素材node_key},所有输入必须明确绑定,不使用模板示例素材。保留技能、原生连接和顺序,返回run_node_key;仅搭图,不生成。 |
| pavo_submit_taskA | 会消耗官网账号额度,仅在用户明确授权模型、参数和费用范围后调用。只提交一次,立即保存真实task_id,不等待生成。UNKNOWN禁止重投。regenerate仅用于用户明确要求再次生成且原任务已终止的情况。 |
| pavo_get_taskA | 按真实任务ID查询原生进度;found=false表示历史暂缺,不能据此重新生成。succeeded依据原生状态,不根据URL猜成功。 |
| pavo_sync_task_resultA | 从本地已保存的生成提交回执定位准确项目和节点,查询并回写状态或成功产物;禁止覆盖后来修改的参数或其他任务。轮询状态变化后需要新的回写operation_id。 |
| pavo_download_task_resultsA | 从原生成功任务的真实结果下载至绝对目录,逐项返回路径、字节数和SHA。复用经回执核SHA的已有文件,不覆盖其他文件;失败只重试下载,不重新生成。 |
| pavo_save_node_assetA | 把节点指定的真实媒体资源保存到官网我的资产。上传资产链路为上传媒体、创建upload节点、保存节点资产。 |
| pavo_list_assetsB | 分页读取账号images或videos资产,保留服务端分页结构。 |
| pavo_list_artifactsA | 读取项目历史真实产物。category=all/images/videos;该接口按日期分组分页,total不是文件总数。 |
| pavo_get_operationB | 查询本地持久化回执:SUCCESS为写请求回执成功,FAILED为明确拒绝,RUNNING/UNKNOWN不得重投。生成提交SUCCESS不等于任务已生成成功。 |
| pavo_script_list_stylesA | 读取独立AI剧本创作入口的实时风格库;使用真实style_id,不把画布模板或模型code当风格ID。 |
| pavo_script_list_projectsA | 分页查询官网/playlet/list剧本项目。is_demo=true读取官方只读演示,不可修改。 |
| pavo_script_get_projectA | 读取剧本原生状态、active_tasks、任务ID、大纲和分集。返回outline及episodes指纹,编辑前必须核对;无任务不代表未知提交未发生。include_content=false的结果不能用来覆盖完整正文。 |
| pavo_script_get_episodeA | 核对项目归属后读取指定集的原生正文和状态,不能跨项目误用分集ID。 |
| pavo_script_create_aiA | 调用官网AI剧本生成,可能消耗额度,需用户授权本次创作与费用。计划1至100集、画幅9:16或16:9,style使用实时style_id或custom_style_prompt。只提交一次并返回真实project_id/task_ids,不自动确认大纲或启动后续媒体。 |
| pavo_script_import_textA | 把未分集的剧情作为requirements交给官网AI生成剧本,由Pavo安排每集内容,不再走完整剧本paste解析。planned_episode_count为用户指定的1至100集,官网接口不支持省略;连同标题及分集说明最多100000个UTF-16单位,不截断原文。可能消耗额度,需本次生成授权;只返回真实创建回执,不自动确认大纲或启动媒体。 |
| pavo_script_upload_fileA | 准备步骤:上传本地非空UTF-8 TXT或真实DOCX并检查,返回file_url和SHA;文件32MiB、解压64MiB上限,不自动创建剧本。后续用import_file及计划集数交给Pavo AI生成分集;保留本地源文件用于核SHA及读取剧情。不发送Bearer到存储,inspect按用户文件上传授权调用。 |
| pavo_script_import_fileA | 使用本账号成功上传回执,核本地源文件SHA并提取剧情,以requirements调用官网AI生成分集,不再调用projects/upload完整剧本解析。兼容原上传回执,但源文件须仍存在且未改;不下载任意URL或重新上传。计划集数1至100;可能消耗额度,需本次生成授权,不自动确认大纲。 |
| pavo_script_update_outlineB | 根据get_project返回的outline指纹修改指定字段。支持story_type/target_audience/one_line_story/story_summary/world_setting/character_biographies(name,bio),保留其余内容,不自动确认大纲。官网无version CAS,避免同时在网页编辑。 |
| pavo_script_update_episodesA | 使用get_project完整内容返回的episodes指纹。episodes每项含episode_id及title/content修改;未指定的已有分集保留。new_episodes含episode_no/title/content。只保存,不自动触发资产提取或后续生成。 |
| pavo_script_get_assetsA | 读取characters/scenes/props与各状态,额外返回_mcp_fingerprints用于手动编辑前核对;不重新提取或生成图片。 |
| pavo_script_create_assetA | 手动新增character角色、scene场景或prop道具及初始状态描述。按原生name/title字段保存,返回真实asset_id/state_id,不生成图片、不自动同步到后续制作。官网只读演示拒绝写入。 |
| pavo_script_rename_assetA | 核本项目、本类型资产及get_assets返回的asset指纹后,只修改角色name或场景/道具title,不改状态描述、图片或绑定。 |
| pavo_script_save_asset_stateA | 不传state_id时新增状态,须省略expected_sha256,patch须含state_name和description;编辑已有状态须传真实state_id及对应states指纹。可改state_name/description/episode_nos/reference_images,参考图使用已上传的HTTPS公网地址。完整保留未改的图片、模型、样式与可编辑绑定,按原生POST states upsert保存;不会发起图片生成。 |
| pavo_script_set_asset_main_imageA | 将已上传的HTTPS图片设为指定状态的形象主图main_image。asset_type为character/scene/prop;须传get_assets对应states指纹与真实像素宽高,比例自动计算,thumbnail_url省略时使用原图。核归属、只读、同名状态歧义及UNKNOWN,按官网art-versions(sync_to_entity=true)保存版本并回读主图;不会触发生成。参考图使用save_asset_state;设置形象图片使用本工具。官网无CAS,避免同时在网页编辑同一状态。 |
| pavo_script_set_character_four_view_imageA | 将已上传的角色四视图设为指定状态的独立四视图图片位,原生字段为three_view_image。须提供get_assets对应states指纹及真实像素宽高;核归属、只读、同名状态及UNKNOWN,保存原生版本并回读目标图片和原有形象主图,保留描述、参考图、模型及绑定。不发起生成,不自动入素材库;官网无CAS,避免同时在网页编辑同一状态。 |
| pavo_script_get_storyboardA | 核项目归属后读取原生段落、场景、镜头及active_tasks,附_mcp_fingerprints.storyboard和各实体指纹供编辑。生成分镜需单独调用run_stage,不会自动制作图片或视频。 |
| pavo_script_update_storyboardA | 按get_storyboard的_mcp_fingerprints.storyboard核对后保存,同一次仅编辑一个片段,整集须逐段调用。shots每项含shot_id及content_rich/duration_sec;scenes每项含scene_id/content_rich,内容仅为一个本项目场景标签,细节写镜头正文。单镜时长为1至15整数,素材标签必须属于本项目。沿官网PATCH shots保存并回读文字、时长、素材引用、派生视频提示词;保护原媒体与其余字段。不生成、不付费;UNKNOWN禁止换号重投。 |
| pavo_script_create_storyboard_segmentA | 沿官网POST episodes/{id}/segments,仅新增指定排序的片段,不复制或删除原镜头。须最新storyboard指纹,回读返回新增对象、官网默认场景镜头及新指纹;保护既有顺序和媒体。不自动生成。拆段应先复制保存并核验,再明确删除已迁移旧镜。 |
| pavo_script_create_storyboard_shotA | 核本项目分集片段归属及最新storyboard指纹,按官网POST segments/{id}/shots新增镜头。返回完整回读及新指纹,不自动填正文、不移动旧镜、不生成媒体。 |
| pavo_script_delete_storyboard_shotA | 明确删除指定镜头,只用于已授权的分镜整理;拆段先完成新段复制保存与核验,再调用本工具。核最新storyboard指纹及归属,禁止删除该场景最后一镜,保留其它内容、排序相对关系和原段媒体,不删除片段或媒体;UNKNOWN禁止换号重投。 |
| pavo_script_delete_storyboard_segmentA | 仅用于明确授权的分镜迁移:先完整保存并人工核完替代段台词/动作,再删除无任何已选及历史媒体的旧AI草稿段。须同集真实非空replacement_segment_ids、最新storyboard指纹、绝对backup_dir;工具先备份整集,再按官网DELETE segments/{id}删除并回读目标消失、替代及其它正文/媒体/顺序保留。不是删除最后一镜的兜底,不删除剧本/资产;UNKNOWN禁止新号重投。 |
| pavo_script_run_stageA | 可能消耗额度,需用户明确授权本阶段。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不得换号重投。不是视频、关键帧或合成接口。 |
| pavo_script_exportA | 读取原生剧本内容后导出到绝对目录,支持json/markdown/doc。doc为与官网同类的Word兼容HTML,不冒称DOCX。可附原生分镜数据,返回SHA和状态;不会触发生成、视频导出或覆盖不同内容的文件。 |
| pavo_script_list_storyboard_episodesA | 读取官网projects/{id}/episodes/storyboard制作分集,不把progress中的剧本草稿分集ID猜作制作分集ID。只读,不生成。 |
| pavo_script_list_media_modelsA | 按官网model_options查询segment_keyframe或segment_video模型与账号约束;不混用canvas类别,不生成。 |
| pavo_script_get_segment_mediaB | 核原生制作分集及片段归属,读取关键帧/视频历史、原生任务状态及选中槽位,返回_mcp_fingerprints.media。关键帧为segment级,一段多镜仍只有该段槽位。 |
| pavo_script_attach_segment_mediaA | 将已上传HTTPS图片/视频沿原生media/upload存历史,再select并回读槽位;image用segment_keyframe,video用segment_video且须明确first_frame_url。核最新media指纹,保护脚本文字和其它媒体。不生图、不生成视频;部分成功保持UNKNOWN,禁止换号重投。 |
| pavo_script_select_segment_mediaB | 只选择该片段原生历史中的唯一media_id,核最新media指纹并回读目标槽位;禁止运行中或失败记录,保留另一槽位和所有原媒体、正文。不生成。 |
| pavo_script_submit_segment_videoB | 消耗额度,须用户已授权模型参数和费用。显式模型、分辨率、style_id或custom_style_prompt、expected_ratio;比例只核项目,原生请求无独立ratio字段。核实时segment_video模型和段总时长、已选关键帧;只调用已核single_frame视频合同,保存唯一真实新task_id。不调用Pavo生图。UNKNOWN禁止重投;重生成须regenerate且旧任务为已核终态。 |
| pavo_script_get_segment_video_taskA | 从本片段原生segment_video历史匹配generation_task_id查询状态,不调用画布get_task。仅已核success/failed作终态判断;未知状态、历史暂缺、运行超5分钟都不能自动重提。失败重试另用明确授权的提交工具。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 57 tools
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.
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.
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.
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.