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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

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
    77
    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.
    72
    AGPL 3.0

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