Claude MarketplacesSubmit
pyjudge avatar

Pdf4vllm

pyjudge/pdf4vllm-mcp

Adds three PDF tools to Claude: list_pdfs for finding files with glob patterns, read_pdf for extracting content as ordered blocks, and grep_pdf for text search. The smart bit is corruption detection. It tries text extraction first, then automatically switches to image mode when it hits encoding garbage or mangled output. You can force text_only or image_only modes, configure page limits to avoid token explosions, and it filters out junk images like logos and headers. Returns JSON with page numbers and content blocks in reading order. Install via pip or uvx, then point Claude Desktop at the server.py script. Requires pdfgrep if you want the search tool.

tools
3
transport
STDIO
last updated
Dec 2, 2025
View on GitHub

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

list_pdfsFind PDF files with glob filtering (`name_pattern`)

Find PDF files with glob filtering (`name_pattern`)

No parameter schema in public metadata yet.

read_pdfExtract PDF content as ordered blocks

Extract PDF content as ordered blocks

No parameter schema in public metadata yet.

grep_pdfSearch text in PDFs using pdfgrep (requires `pdfgrep` installed)

Search text in PDFs using pdfgrep (requires `pdfgrep` installed)

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

pdf4vllm

License: MIT Python 3.10+ PyPI Open in Gitpod

PDF reading MCP server optimized for vision LLMs.

한국어

문제

방식문제점
텍스트 추출인코딩 깨짐 → 쓰레기 출력, 이미지-텍스트 순서 뒤섞임
이미지 변환토큰 폭발 (특히 페이지 많을 때)

해결

pdf4vllm은 PDF가 지저분하다고 가정합니다.

  • 텍스트 손상 자동 감지 → 이미지로 자동 전환
  • 읽기 순서 보존 (텍스트 → 표 → 이미지 블록 순서대로)
  • 페이지 제한으로 컨텍스트 오버플로우 방지
  • 불필요한 이미지 자동 필터링 (로고, 선, 헤더/푸터)

설치

pip install pdf4vllm-mcp
# 또는
uvx pdf4vllm-mcp

Claude Desktop 설정

git clone https://github.com/PyJudge/pdf4vllm-mcp.git
cd pdf4vllm-mcp
python scripts/install_mcp.py

또는 직접 설정 (~/Library/Application Support/Claude/claude_desktop_config.json):

View the full README on GitHub

Details

Repository
github.com/pyjudge/pdf4vllm-mcp
Category
Documents & Knowledge
Package
pdf4vllm-mcp
Transport
STDIO
Registry
MCP registry, active

Related Documents & Knowledge MCP servers

View all
1rehmansherazi avatarSyncbridge Mcprehmansherazi/syncbridgeBridges AI chat interfaces with Claude Code CLI via shared markdown control files.0stars
2rog0x avatarWebrog0x/mcp-web-toolsWeb scraping, search, monitoring, and HTML-to-markdown for AI agents0stars
3team-earth avatarDataGraphio.github.team-earth/datagraphUrban intelligence knowledge graph. Structured locality data for civic problem-solving.0stars
4stackfast-technologies avatarStackFast FractWin Expert Brainstackfast-technologies/mcp-brain-serverExpert knowledge base for sales, negotiation, strategy, operations, and risk.0stars
5zhugejun avatarChartonezhugejun/chartone-mcpRender themed charts as hosted URLs. Embed in markdown, emails, and Slack. Hosted MCP, zero setup.0stars
6siteglassio avatarMcpsiteglassio/siteglass-mcpArchive any URL to a shareable rrweb/pdf/png snapshot + agent-driven web QA (scan, run E2E flows).0stars