Skip to main content
Glama
sandraschi

pdf-mcp

by sandraschi

pdf-mcp

Full-stack PDF intelligence MCP server — extract, manipulate, annotate, convert, validate, and RAG-search PDFs through a unified tool surface and React workbench.

v0.2.1 · Ports 11130 (frontend) / 11131 (backend)

FastMCP 3.4.4 · PyMuPDF + pypdf + pdfplumber · LanceDB RAG · Prefab UI · dual transport (stdio + HTTP)

Features

  • pdf_extract — text, images, tables, metadata, fonts, links, outline

  • pdf_manipulate — merge, split, rotate, reorder, delete pages, compress, encrypt/decrypt, optimize

  • pdf_annotate — watermark, stamp, highlight, underline, header/footer, page numbers, auto summary box

  • pdf_forms — list / fill / flatten / export + LLM-guided auto-fill

  • pdf_convert — PDF ↔ Markdown / images / HTML

  • pdf_validate — PDF/A, structure, accessibility, integrity, compare

  • pdf_rag — chunk (table-aware), index (LanceDB), semantic search, query-by-example, cross-document synthesis

  • pdf_analyze / pdf_redact / pdf_classify / pdf_dedupe / pdf_export — intelligence tools

  • pdf_do — autonomous agent that chains the tools from natural language

  • pdf_help / pdf_status / pdf_shutdown — meta tools

Related MCP server: pdf-mcp

Quick start

git clone https://github.com/sandraschi/pdf-mcp
cd pdf-mcp
uv sync
Copy-Item .env.example .env
.\start.ps1

Dashboard: http://127.0.0.1:11130 · MCP/API: http://127.0.0.1:11131

Stack

  • Backend: Python 3.12, FastMCP 3.4.4, Starlette (HTTP), PyMuPDF, pypdf, pdfplumber, LanceDB, Prefab UI

  • Frontend: React 18, Vite 5, Tailwind CSS, Lucide, Framer Motion, Zustand, PDF.js, Playwright

  • Tooling: uv, bun, just, ruff, pyright, Biome, pre-commit

MCP tools

Tool

Operations

pdf_extract

text, images, tables, metadata, fonts, links, outline

pdf_manipulate

merge, split, rotate, reorder, delete_pages, compress, encrypt, decrypt, optimize

pdf_annotate

watermark, stamp, highlight, underline, header_footer, page_numbers, summary_box

pdf_forms

list_fields, fill, flatten, export_data, auto_fill

pdf_convert

to_markdown, to_images, to_html, from_html, from_markdown, from_images

pdf_validate

pdfa, structure, accessibility, integrity, compare

pdf_rag

chunk, index, search, similar, synthesize, list_documents, delete_index

pdf_analyze / pdf_redact / pdf_classify / pdf_dedupe / pdf_export

intelligence

pdf_do

agentic chaining

pdf_help / pdf_status / pdf_shutdown

meta

Claude Desktop config

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uv",
      "args": ["--directory", "D:\\Dev\\repos\\pdf-mcp", "run", "python", "run_server.py"]
    }
  }
}

For HTTP mode instead: uv run python run_server.py --mode http --port 11131 and connect over http://127.0.0.1:11131/mcp.

Configuration

See docs/CONFIGURATION.md. Key vars: MCP_MODE (stdio/http), MCP_PORT (11131), FRONTEND_PORT (11130), RAG_STORE_PATH, UPLOAD_DIR.

Webapp

Route

Page

/

Dashboard (KPIs, LLM availability, usage stats)

/workbench

PDF.js viewer + OCR badge + compare mode + tool palette

/pipeline

Single operations + multi-step recipes + share links

/chat

LLM chat with PDF search + source citations

/tools / /skills / /logs

Discovery & logs

Documentation

License

MIT

A
license - permissive license
Not graded
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables comprehensive PDF analysis and manipulation including page size analysis, chapter extraction, splitting, compression, merging, and conversion to images. Provides both MCP server interface for AI assistants and Streamlit web interface for direct user interaction.
  • A
    license
    A
    quality
    C
    maintenance
    An MCP server for reading, rendering, and searching PDF files, specifically optimized for LLMs to extract text, tables, and technical diagrams. It enables metadata retrieval, multi-format text extraction, and page-to-image rendering using PyMuPDF.
    5
    66
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    MCP server that reads PDFs and exposes them as structured Markdown, metadata, outlines, images, and tables to LLM consumers via tools like pdf_read_markdown and pdf_info.
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP server for exporting PDF to markdown, optimized for LLM consumption.
    69
    AGPL 3.0

View all related MCP servers

Related MCP Connectors

  • MCP server for the PDFGate API. Generate PDFs, manage documents and handle e-signatures.

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

  • Generate PDFs from templates via AI chat. Works with Claude, ChatGPT, Cursor, and any MCP client.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandraschi/pdf-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server