PDF Manipulation MCP Server

Instructions

Implementation Reference

• pdf_manipulation_mcp_server/pdf_server.py:991-1027 (handler)

  The handler function for the 'pdf_set_metadata' tool. It validates the PDF file, opens it using PyMuPDF (fitz), iteratively sets each metadata field provided in the input dictionary, generates a timestamped output filename to avoid overwriting the original, saves the modified PDF, and returns a success message with the updated fields and output path.

  @mcp.tool()
  async def pdf_set_metadata(
      pdf_path: str,
      metadata: Dict[str, str]
  ) -> str:
      """Set metadata for a PDF."""
      if not os.path.exists(pdf_path):
          return f"Error: PDF file not found: {pdf_path}"
      
      if not validate_pdf_file(pdf_path):
          return f"Error: Invalid PDF file: {pdf_path}"
      
      try:
          # Open PDF document
          doc = fitz.open(pdf_path)
          
          # Set metadata fields
          updated_fields = []
          for field, value in metadata.items():
              if value:  # Only set non-empty values
                  doc.set_metadata({field: str(value)})
                  updated_fields.append(f"{field}: {value}")
          
          # Generate output filename
          output_path = generate_output_filename(pdf_path)
          
          # Save the modified PDF
          doc.save(output_path)
          doc.close()
          
          if updated_fields:
              return f"Successfully updated metadata. Output saved to: {output_path}\nUpdated fields:\n" + "\n".join(updated_fields)
          else:
              return "No metadata fields to update."
          
      except Exception as e:
          return f"Error setting PDF metadata: {str(e)}"