pdf-figures-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
pdf-figures-mcp
An MCP tool server that inventories and extracts figures, tables and captions
from research-paper PDFs for the Veramiko Bibliographer on
llm.ronzz.org.
Pipeline:
OWUI upload store (ro) -> pdf-figures (MCP) -> /figures -> mediawiki-mcp-writer -> wiki File:The wiki writer mounts /figures read-only and lists it in uploadDirs, so the
local_path returned by extract_pdf_figure is uploadable verbatim.
Tools
Tool | Returns |
| JSON inventory: |
| Text summary ( |
| Same summary for an arbitrary page region (uncaptioned or scanned content). |
Related MCP server: PDF Figures MCP Server
Detection
Captions are the anchors:
Figure|Fig.|Table|Scheme|Chart|Diagram|Plate <N>[:.](the punctuation requirement rejects sentences such as "Table 2 summarizes…").Vector paths (
Page.get_drawings()) and raster images (Page.get_image_rects()) are clustered; the nearest cluster above or below the caption wins; side-by-side panels with one caption are merged.Tables are bounded from the caption to the next vertical gap (> 20 pt) or heading.
Large uncaptioned clusters (≥ 8 % of the page) are listed with
caption: null.Scanned pages (no text layer, one image covering ≥ 80 % of the page) are detected, reported in
scanned_pages, and OCR'd on request only: PyMuPDFget_textpage_ocr→ Tesseract (eng,fra,epo). The figure band is the ink-bounded area on the caption's side of the page.
Rendering
Default 600 DPI, maximum 600.
Caps: 48 MP, 8000 px on the long edge, one render at a time (
mem_limit 1g).The model preview is downscaled to 1024 px; only the file on
/figuresis full resolution.OCR always runs at 300 DPI (Tesseract's accuracy plateau).
Configuration
Env | Default |
|
|
|
|
|
|
|
|
Paths are absolute, realpath-resolved and checked against the allowlist;
symlinks that escape a root are rejected. Only .pdf files are accepted.
Run
uv sync --extra dev
uv run pytest
uv run python -m pdf_figures.server # streamable HTTP on :8000/mcpDocker: docker build -t pdf-figures . (arm64 image via CI).
Licence
AGPL-3.0-or-later (PyMuPDF is AGPL-3.0).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Extract tables, text and formulas from PDFs, including scanned pages and broken text layers.
PDF URLs to per-page text, tables as rows, Markdown, metadata and OCR for scanned pages.
Extract text, tables and metadata from every PDF linked in a dataset, CSV or Google Sheet.
High-fidelity PDF to structured Markdown conversion and document field extraction.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI-powered extraction and analysis of PDF documents with 40+ specialized tools for text, tables, images, layout analysis, security assessment, and document intelligence. Supports both text-based and scanned PDFs with OCR capabilities.192 PyPI11MIT
- AlicenseNot gradedqualityDmaintenanceExtracts figures and tables from PDF documents via a FastAPI service, wrapping PDFFigures 2.0. Enables AI agents to programmatically retrieve structured figure and table data from scholarly PDFs.9Apache 2.0
- AlicenseAqualityDmaintenanceEnables RAG over messy PDFs — extract, chunk, embed, and search scanned, multi-column, and table-heavy documents.6MIT
- AlicenseBqualityCmaintenanceEnables users to extract text from scanned PDF pages and images using existing text layers or Tesseract OCR, returning lines and words with bounding boxes and confidence scores. It also supports searching pages, reading specific regions, and caching results so extracted numbers can be checked against the page.62MIT