PowerPoint Translator

Instructions

Implementation Reference

• mcp_server.py:266-319 (handler)

  The main handler function for the 'get_slide_info' MCP tool. It validates the input PPTX file path, retrieves the slide count and previews (up to 10 slides) using PowerPointTranslator, formats a detailed information report, and includes usage examples. Registered via @mcp.tool() decorator.

  @mcp.tool()
  def get_slide_info(input_file: str) -> str:
      """
      Get information about slides in a PowerPoint presentation.
      
      Args:
          input_file: Path to the PowerPoint file (.pptx)
      
      Returns:
          Information about the presentation including slide count and preview of each slide
      """
      try:
          # Validate input file using helper function
          input_path, error_msg = validate_input_path(input_file)
          if error_msg:
              return error_msg
          
          # Create translator to access slide info methods
          translator = PowerPointTranslator()
          slide_count = translator.get_slide_count(str(input_path))
          
          info_text = f"""📊 PowerPoint Presentation Information
  
  📁 File: {input_path}
  📄 Total slides: {slide_count}
  
  📋 Slide previews:
  """
          
          # Get preview for each slide (limit to first 10 slides for readability)
          max_preview_slides = min(slide_count, 10)
          for i in range(1, max_preview_slides + 1):
              try:
                  preview = translator.get_slide_preview(str(input_path), i, max_chars=150)
                  info_text += f"\n🔸 Slide {i}: {preview}"
              except Exception as e:
                  info_text += f"\n🔸 Slide {i}: [Error getting preview: {str(e)}]"
          
          if slide_count > 10:
              info_text += f"\n\n... and {slide_count - 10} more slides"
          
          info_text += f"""
  
  💡 Usage examples:
  • Translate all slides: translate_powerpoint("{input_file}")
  • Translate specific slides: translate_specific_slides("{input_file}", "1,3,5")
  • Translate slide range: translate_specific_slides("{input_file}", "2-4")"""
          
          return info_text
          
      except Exception as e:
          logger.error(f"Failed to get slide info: {str(e)}")
          return f"❌ Failed to get slide info: {str(e)}"

• mcp_server.py:26-69 (helper)

  Shared helper function used by get_slide_info (and other tools) to validate and resolve the input PowerPoint file path, checking existence and .pptx extension, providing detailed error messages.

  def validate_input_path(input_file: str) -> tuple[Path, str]:
      """
      Validate input file path, handling both absolute and relative paths.
      
      Args:
          input_file: Input file path (absolute or relative)
      
      Returns:
          Tuple of (validated_path, error_message). If error_message is not empty, path validation failed.
      """
      input_path = Path(input_file)
      
      # If it's a relative path, try to resolve it from current working directory
      if not input_path.is_absolute():
          # Try current working directory first
          cwd_path = Path.cwd() / input_file
          if cwd_path.exists():
              input_path = cwd_path
          else:
              # Try the script's directory as fallback
              script_dir = Path(__file__).parent
              script_path = script_dir / input_file
              if script_path.exists():
                  input_path = script_path
      
      if not input_path.exists():
          # Provide more helpful error message with current working directory info
          cwd = Path.cwd()
          script_dir = Path(__file__).parent
          error_msg = f"""❌ Error: File not found: {input_file}
  📁 Current working directory: {cwd}
  📁 Script directory: {script_dir}
  💡 Tried paths:
     • {input_file} (as provided)
     • {cwd / input_file} (from current directory)
     • {script_dir / input_file} (from script directory)
  💡 Try using absolute path or ensure file is in one of these directories"""
          return input_path, error_msg
      
      if not input_path.suffix.lower() == '.pptx':
          return input_path, f"❌ Error: File must be a PowerPoint (.pptx) file: {input_file}"
      
      return input_path, ""