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: