JianYing MCP

Instructions

Implementation Reference

• jianyingdraft/tool/audio_tool.py:207-285 (handler)

  MCP tool handler for 'add_audio_fade': input validation, index lookup, delegates to service.
  @mcp.tool() def add_audio_fade( audio_segment_id: str, in_duration: str, out_duration: str ) -> ToolResponse: """ 为音频片段添加淡入淡出效果 Args: audio_segment_id: 音频片段ID，通过add_audio_segment获得 in_duration: 音频淡入时长，格式如 "1s", "500ms", "0.5s" out_duration: 音频淡出时长，格式如 "1s", "500ms", "0.5s" """ # 参数验证 if not in_duration or not out_duration: return ToolResponse( success=False, message="淡入时长和淡出时长不能为空" ) # 简单的时间格式验证 def validate_duration(duration: str) -> bool: """验证时间格式是否正确""" if not duration: return False # 检查是否以s或ms结尾 if not (duration.endswith('s') or duration.endswith('ms')): return False # 检查数字部分 try: if duration.endswith('ms'): float(duration[:-2]) else: float(duration[:-1]) return True except ValueError: return False if not validate_duration(in_duration): return ToolResponse( success=False, message=f"无效的淡入时长格式: {in_duration}，正确格式如 '1s', '500ms'" ) if not validate_duration(out_duration): return ToolResponse( success=False, message=f"无效的淡出时长格式: {out_duration}，正确格式如 '1s', '500ms'" ) # 通过audio_segment_id获取相关信息 draft_id = index_manager.get_draft_id_by_audio_segment_id(audio_segment_id) track_info = index_manager.get_track_info_by_audio_segment_id(audio_segment_id) if not draft_id: return ToolResponse( success=False, message=f"未找到音频片段ID对应的草稿: {audio_segment_id}" ) if not track_info: return ToolResponse( success=False, message=f"未找到音频片段ID对应的轨道信息: {audio_segment_id}" ) track_name = track_info.get("track_name") # 调用服务层处理业务逻辑 result = add_audio_fade_service( draft_id=draft_id, audio_segment_id=audio_segment_id, in_duration=in_duration, out_duration=out_duration, track_name=track_name ) return result
• jianyingdraft/services/audio_service.py:175-244 (helper)

  Helper service implementing the core logic: creates AudioSegment instance and calls add_fade method.
  def add_audio_fade_service( draft_id: str, audio_segment_id: str, in_duration: str, out_duration: str, track_name: Optional[str] = None ) -> ToolResponse: """ 音频淡入淡出添加服务 - 为音频片段添加淡入淡出效果 Args: draft_id: 草稿ID audio_segment_id: 音频片段ID in_duration: 音频淡入时长，格式如 "1s"、"500ms" out_duration: 音频淡出时长，格式如 "1s"、"500ms" track_name: 轨道名称（可选） Returns: ToolResponse: 包含操作结果的响应对象 """ try: # 创建AudioSegment实例，传入audio_segment_id audio_segment = AudioSegment(draft_id, audio_segment_id=audio_segment_id, track_name=track_name) # 调用音频淡入淡出添加方法 result_data = audio_segment.add_fade( in_duration=in_duration, out_duration=out_duration ) # 构建返回数据 response_data = { "audio_segment_id": audio_segment_id, "draft_id": draft_id, "in_duration": in_duration, "out_duration": out_duration, "add_fade": result_data } # 添加可选参数到返回数据 if track_name: response_data["track_name"] = track_name return ToolResponse( success=True, message=f"音频淡入淡出添加成功: 淡入{in_duration}, 淡出{out_duration}", data=response_data ) except ValueError as e: # 处理参数错误 return ToolResponse( success=False, message=f"参数错误: {str(e)}" ) except NameError as e: # 处理轨道不存在错误 return ToolResponse( success=False, message=f"轨道错误: {str(e)}" ) except Exception as e: # 处理其他未预期的错误 return ToolResponse( success=False, message=f"音频淡入淡出添加失败: {str(e)}" )
• jianyingdraft/tool/audio_tool.py:8-9 (registration)

  Import of the service functions used by the audio tools, including add_audio_fade_service.
  from jianyingdraft.services.audio_service import add_audio_segment_service, add_audio_effect_service, \ add_audio_fade_service, add_audio_keyframe_service
• jianyingdraft/tool/audio_tool.py:208-212 (schema)

  Type hints and docstring defining input schema for the tool.
  def add_audio_fade( audio_segment_id: str, in_duration: str, out_duration: str ) -> ToolResponse: