JianYing MCP

Instructions

Implementation Reference

• jianyingdraft/tool/utility_tool.py:90-137 (handler)

  The main MCP tool handler and registration for 'parse_media_info'. It accepts media_path, imports and calls the helper from media_parser.py, constructs a ToolResponse with media information or error.

  @mcp.tool()
  def parse_media_info(media_path: str) -> ToolResponse:
      """
      解析媒体文件信息
      
      Args:
          media_path: 媒体文件路径或URL，支持本地文件和网络URL,不论任何类型的文件都可以，视频可返回时长、分辨率，图片可返回尺寸
      """
      try:
          from jianyingdraft.utils.media_parser import parse_media_info as parse_func
          
          # 调用解析函数
          media_info = parse_func(media_path)
          
          if media_info is None:
              return ToolResponse(
                  success=False,
                  message=f"无法解析媒体文件: {media_path}"
              )
          
          # 构建返回数据
          response_data = {
              "media_path": media_path,
              "media_info": media_info
          }
          
          # 提取关键信息用于消息
          media_type = media_info.get("type", "未知")
          duration = media_info.get("duration")
          resolution = media_info.get("resolution")
          
          message_parts = [f"成功解析 {media_type} 文件"]
          if duration:
              message_parts.append(f"时长: {duration}")
          if resolution:
              message_parts.append(f"分辨率: {resolution}")
          
          return ToolResponse(
              success=True,
              message=", ".join(message_parts),
              data=response_data
          )
          
      except Exception as e:
          return ToolResponse(
              success=False,
              message=f"解析媒体文件失败: {str(e)}"
          )

• jianyingdraft/utils/media_parser.py:20-37 (helper)

  Core parsing method in MediaParser class that dispatches to local or URL parsing using pymediainfo for media info extraction.

  def parse_media_info(self, media_path: str) -> Optional[Dict[str, Any]]:
      """
      解析媒体文件信息
      
      Args:
          media_path: 媒体文件路径或URL
          
      Returns:
          Dict: 媒体信息，包含duration等字段，解析失败返回None
      """
      try:
          if self._is_url(media_path):
              return self._parse_url_media(media_path)
          else:
              return self._parse_local_media(media_path)
      except Exception as e:
          print(f"解析媒体信息失败: {e}")
          return None

• jianyingdraft/utils/media_parser.py:254-269 (helper)

  Convenience helper function imported by the tool handler. Instantiates MediaParser and calls its parse_media_info method, ensuring cleanup.

  def parse_media_info(media_path: str) -> Optional[Dict[str, Any]]:
      """
      解析媒体文件信息的便捷函数
      
      Args:
          media_path: 媒体文件路径或URL
          
      Returns:
          Dict: 媒体信息，解析失败返回None
      """
      parser = MediaParser()
      try:
          return parser.parse_media_info(media_path)
      finally:
          parser.cleanup_all_temp_files()

• jianyingdraft/server.py:21-31 (registration)

  Server registration where utility_tools (containing parse_media_info) is invoked to register the tools with the MCP server.

  from jianyingdraft.tool.utility_tool import utility_tools
  
  
  def main():
      # 注册所有工具
      draft_tools(mcp)
      track_tools(mcp)
      video_tools(mcp)
      text_tools(mcp)
      audio_tools(mcp)
      utility_tools(mcp)