pdf-chart-parser
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pdf-chart-parser Extract the usage chart from my electricity bill PDF."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
pdf-chart-parser
An MCP server and Python library that extracts energy-usage charts from utility-bill PDFs. It locates the chart, calibrates the axes from the PDF's text layer, and returns structured time-series data alongside an annotated PNG for visual verification — entirely deterministic, no LLM required.
Features
Bar, line, and hybrid (bar + line, dual y-axis) chart types
Vector-first extraction via PyMuPDF
get_drawings()/get_text("dict"); OpenCV raster fallback for scanned PDFsScanned-PDF support via an OCRmyPDF text-layer step (optional
[ocr]extra): image-only pages get a searchable text layer so they flow through the same high-accuracy text-layer calibration as digital PDFsFull page text returned as LLM-friendly Markdown (via
pymupdf4llm)MCP tool (
extract_usage_chart) compatible with Claude and other MCP-aware LLMsSupports
stdiotransport (local) andstreamable-http(containerized deployment)Returns structured JSON + annotated PNG; numeric data is always text content
Related MCP server: DeepSeek PDF Reader
Installation
Prerequisites
Python 3.12+
uvpackage managerTesseract OCR (required only for the
[raster]extra):apt-get install tesseract-ocrorbrew install tesseractOCRmyPDF system tools (required only for the
[ocr]extra, which adds a searchable text layer to scanned PDFs):apt-get install ghostscript qpdf unpaper pngquant tesseract-ocrorbrew install ocrmypdf
Quickstart
# Install (vector path only)
uv sync
# Install with raster fallback
uv sync --extra raster
# Install with the OCR text-layer step for scanned PDFs
uv sync --extra ocr
# Install everything
uv sync --extra raster --extra ocr
# Run the CLI
uv run pdf-chart-parser --help
# Run the MCP server (stdio)
uv run python -m pdf_chart_parser.serverUsage
Python library
from pdf_chart_parser.pipeline import extract_usage_chart
result = extract_usage_chart(pdf_path="bill.pdf", return_annotated_image=True)
print(result["chart_type"]) # "bar" | "line" | "hybrid"
for series in result["series"]:
print(series["label"], series["points"])CLI
uv run pdf-chart-parser extract bill.pdf --output result.jsonMCP server
Add to your MCP config (~/.claude/claude_desktop_config.json or similar):
{
"mcpServers": {
"pdf-chart-parser": {
"command": "uv",
"args": ["run", "python", "-m", "pdf_chart_parser.server"],
"cwd": "/path/to/pdf-chart-parser"
}
}
}The server exposes the extract_usage_chart tool. It returns:
Page text — full page as Markdown
Chart reading — structured JSON (series, axes, confidence, warnings)
Annotated PNG — cropped chart with calibrated gridlines and data-point markers
Docker / ECR deployment
# Build and run locally
./scripts/run_local_server.sh
# Build and push to ECR (set ECR_REPO first)
export ECR_REPO=<account>.dkr.ecr.<region>.amazonaws.com/pdf-chart-parser
./scripts/build_and_push.shThe container starts the server on streamable-http at port 8000. A local PDF directory can be bind-mounted to /data for ad-hoc testing (see docker/docker-compose.yml).
Manual testing (no LLM)
# In-process test against fixtures
uv run python scripts/run_manual_tests.py
# Against a running HTTP server
uv run python scripts/run_manual_tests.py --http http://localhost:8000Output is written to manual_test_output/.
License
AGPL-3.0-or-later. This license is required because the project links against PyMuPDF, which is itself AGPL-3.0 licensed.
Available Tools
1 toolextract_usage_chartA
Extract energy-usage chart data from a utility-bill PDF.
Returns the full page text as Markdown, structured chart data as JSON, and optionally an annotated PNG of the chart region.
Provide exactly one of pdf_path, pdf_base64, or pdf_url.
The result includes a 'series' list. When the chart contains multiple utility types (e.g. electricity and gas on the same chart), each type is returned as a separate Series entry with its own 'id' ('s0', 's1', …) and 'color'. The caller is responsible for determining which series corresponds to which utility — use the bar colors, the series order, and the page Markdown context to make that determination.
Inputs: pdf_path, pdf_base64, pdf_url, page, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is zero ambiguity. An agent cannot confuse it with any other tool in the set.
With a single tool, naming consistency is trivially maintained. The name 'extract_usage_chart' follows a clear verb_noun pattern.
A single tool is appropriate for the narrow, focused domain of extracting chart data from utility bill PDFs. Adding more tools would likely be unnecessary.
For its stated purpose of extracting energy-usage chart data, the tool provides text, structured JSON, and optional annotated images. There are no obvious gaps in the surface for this specific task.
Related MCP Connectors
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
MCP server for detecting and redacting PII (Personally Identifiable Information) in PDF documents.
Document conversion MCP server: PDF to Markdown, image OCR, spreadsheet parsing.
Screenshots, PDFs, image editing, QR codes, email validation and more through one hosted MCP server.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides comprehensive PDF processing capabilities including text extraction, image extraction, table detection, annotation extraction, metadata retrieval, page rendering, and document structure analysis.-
- AlicenseNot gradedqualityDmaintenanceMCP server for comprehensive PDF processing including text extraction with OCR, keyword search with regex, table extraction, and page preview as Base64 PNG images.1MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that extracts clean text, tables, and structured data from documents, images, code, and audio files, supporting 97 formats with OCR, transcription, and code intelligence.MIT

clichefactory-mcpofficial
AlicenseNot gradedqualityCmaintenanceMCP server for ClicheFactory, enabling structured data extraction from documents such as PDFs, images, and office files via AI assistants.69 PyPIMIT