JianYing MCP

Instructions

Implementation Reference

• jianyingdraft/tool/draft_tool.py:24-68 (handler)

  The handler function for the 'rules' tool, decorated with @mcp.tool() to register it with the FastMCP server. It returns a standardized set of rules and guidelines for using the video drafting tools.
  @mcp.tool() def rules(): """制作视频的规范，这一步必须执行，方便了解如何规范的使用工具制作视频""" prompt = """ 核心工作原则 1.询问用户应当怎么制作视频，有什么建议，你可以使用parse_media_info（了解素材信息），然后不断地向用户询问制作视频的细节，在制作前，你应该向用户说明你准备怎么制作视频，用户没有意见后才开始制作视频 2. 严格遵循操作流程 必须按照以下顺序执行，不可跳步骤： 创建草稿 → create_draft 创建轨道 → create_track（根据需要创建video、audio、text轨道） 添加素材 → add_*_segment（添加视频、音频、文本片段） 查询特效 → find_effects_by_type（查找可用特效） 应用特效 → add_*_effect/animation（添加各种特效和动画） 导出草稿 → export_draft 3. ID管理规则 draft_id：创建草稿后获得，用于所有后续操作 track_id：创建轨道后获得，用于添加对应类型的素材 segment_id：添加素材后获得，用于添加特效和动画 严格保存和传递这些ID，它们是工具链的关键纽带 4.轨道规则 一般情况下同类型的轨道只需要一个就可以，除非需要画中画等复杂情况才会创建多个同类型的轨道 5.时长规则 在规划视频、音频时长时，必须从素材本身时长出发，使用本身的时长，切记不能超出素材本身时长 注意素材的总时长，在传入target_timerange参数时，所占的轨道时长不能超过素材总时长，不能因为其他原因使得轨道时长超过素材时长，例如当视频总时长5s，音频时长为4.2s，不能因为视频比音频时间长，就改变音频轨道时长，即音频可传入的最大时长为4.2s 添加素材的add_audio_segment和add_video_segment工具中，target_timerange参数描述的是轨道上的时间范围，同一轨道中不可有重复时间段，即0s-4.2s和4s-5s，第一段素材最后0.2s与第二段素材重叠了，只能是0s-4.2s和4.ss-5s 添加素材的add_audio_segment和add_video_segment工具中，source_timerange参数描述的是素材本身取的时长，默认取全部时长，一般情况下不设置，除非用户说明，若素材时长为5s,用户需要取其中1s-5s的内容，才配置 6.其他 add_text_segment工具其中的参数clip_settings的transform_y，强烈建议修改为-0.7(这样字幕是在正下方，不影响视频观感) 特效不存在：查看建议列表，选择相似特效 时间冲突：调整时间范围，查看素材时间以及工具参数 添加转场：若三个视频间需要添加转场，那转场应该添加在第一个和第二个视频后添加转场，而非第二个和第三个视频里 """ return ToolResponse( success=True, message="获取成功", data={"rules": prompt} )
• jianyingdraft/server.py:26-26 (registration)

  The invocation of draft_tools(mcp) in the main server file, which triggers the registration of the 'rules' tool (and others) into the MCP server instance.
  draft_tools(mcp)