parse_media_info
Extract technical details from media files, including video duration and resolution or image dimensions, to support automated video editing workflows in JianYing.
Instructions
解析媒体文件信息
Args: media_path: 媒体文件路径或URL，支持本地文件和网络URL,不论任何类型的文件都可以，视频可返回时长、分辨率，图片可返回尺寸
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media_path | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| message | Yes | ||
| success | Yes |
Implementation Reference
- 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)}" ) - 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 - 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)