概览/MCP/可用工具

可用工具

查看当前可用的 tools、resources 和 prompts,以及推荐调用顺序。

可用工具

KPainter MCP 当前对齐的是最小 public OpenAPI 能力面。

Tools

Tool 用途
kp_health 检查 MCP 适配层是否可达
kp_me 校验当前 API Key,并确认是否具备创作能力
kp_get_catalog 读取当前允许的内容类型、音色、风格和限制
kp_create_creation 发起一次内容创建
kp_list_creations 查看当前用户的创作列表
kp_get_creation 读取单条创作的完整详情、URL、artifacts 和 scenes
kp_get_job_status 轮询创建或编辑任务状态
kp_edit_scene 发起一次支持的单场景编辑

Resources

Resource 用途
kp://openapi/overview 查看 public OpenAPI 和 MCP 工作流概览
kp://catalog/default 读取服务端默认 key 对应的 catalog
kp://creations/{creation_id} 读取服务端默认 key 对应的创作详情

resources 更适合作为辅助读取面。真正的用户级工作流,主入口仍然是 tools。

Prompts

Prompt 用途
create_creation_workflow 引导模型完成类型选择和异步创建
edit_scene_workflow 引导模型完成一次单场景编辑

推荐调用顺序

新建内容时:

  1. kp_me
  2. kp_get_catalog
  3. kp_create_creation
  4. kp_get_job_status
  5. kp_get_creation

改单场景时:

  1. kp_get_creation
  2. 检查 editable_actionsscenes
  3. kp_edit_scene
  4. kp_get_job_status
  5. kp_get_creation

几条最重要的注意点

  • 先调 kp_get_catalog,再决定内容类型和参数
  • 创建和编辑都按异步工作流处理
  • 只使用正式内容类型:explainer_videoslides_videovector_animationslide_deckimageinteractive_lesson
  • knowledge_videoweb_app 这类旧别名在输入侧可能仍兼容,但 catalog 驱动工作流应以上面这组正式名为准
  • kp_edit_scene 当前支持 update_scene_narrationregenerate_scene
  • MCP 不暴露支付、订阅、API Key 管理,也不替代主站更重的编辑能力