PDF Manipulation MCP Server

Instructions

Implementation Reference

• pdf_manipulation_mcp_server/pdf_server.py:267-329 (handler)

  The primary handler function for the 'pdf_add_annotation' tool, decorated with @mcp.tool() for automatic registration in FastMCP. It adds text, highlight, underline, or strikeout annotations to a PDF page at specified coordinates using PyMuPDF.

  @mcp.tool()
  async def pdf_add_annotation(
      pdf_path: str,
      page_number: int,
      annotation_type: str,
      x: float,
      y: float,
      width: float,
      height: float,
      content: str
  ) -> str:
      """Add an annotation to 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)
          
          # Validate page number
          if not validate_page_number(doc, page_number):
              doc.close()
              return f"Error: Invalid page number {page_number}. Document has {len(doc)} pages."
          
          # Get the page
          page = doc[page_number]
          
          # Create rectangle for annotation
          rect = fitz.Rect(x, y, x + width, y + height)
          
          # Add annotation based on type
          if annotation_type == "text":
              annot = page.add_text_annot(rect, content)
          elif annotation_type == "highlight":
              annot = page.add_highlight_annot(rect)
              annot.set_info(content=content)
          elif annotation_type == "underline":
              annot = page.add_underline_annot(rect)
              annot.set_info(content=content)
          elif annotation_type == "strikeout":
              annot = page.add_strikeout_annot(rect)
              annot.set_info(content=content)
          else:
              doc.close()
              return f"Error: Invalid annotation type: {annotation_type}"
          
          # Update annotation appearance
          annot.update()
          
          # Generate output filename
          output_path = generate_output_filename(pdf_path)
          
          # Save the modified PDF
          doc.save(output_path)
          doc.close()
          
          return f"Successfully added {annotation_type} annotation to PDF. Output saved to: {output_path}"
          
      except Exception as e:
          return f"Error adding annotation to PDF: {str(e)}"