Is the pdf4vllm MCP server free to use?

Yes. pdf4vllm is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

Is the pdf4vllm MCP server free to use?

Yes. pdf4vllm is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

Pdf4vllm

PDF reader for vision LLMs. Auto-detects text corruption and switches to image mode.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "pdf4vllm": {
      "command": "npx",
      "args": [
        "-y",
        "pdf4vllm"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Documentation Overview

pdf4vllm

PDF reading MCP server optimized for vision LLMs.

한국어

문제

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

해결

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

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

설치

Terminal

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

Claude Desktop 설정

bash

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):

config.json

{
  "mcpServers": {
    "pdf4vllm": {
      "command": "/python/경로",
      "args": ["/pdf4vllm-mcp/경로/src/server.py"]
    }
  }
}

도구

도구	설명
`list_pdfs`	PDF 파일 찾기 (glob 패턴 `name_pattern` 지원)
`read_pdf`	PDF 내용 블록으로 추출
`grep_pdf`	PDF 내 텍스트 검색 (`pdfgrep` 설치 필요)

추출 모드

모드	설명
`auto` (기본)	텍스트 추출 시도 → 손상 감지 시 이미지로 전환
`text_only`	텍스트/표만 추출, 이미지 없음
`image_only`	페이지를 이미지로만 렌더링

Problem

Approach	Issue
Text extraction	Encoding corruption → garbage output, mixed text-image ordering
Image conversion	Token explosion (especially with many pages)

Solution

pdf4vllm assumes PDFs are messy.

Auto-detects text corruption → switches to image automatically
Preserves reading order (text → table → image blocks in sequence)
Page limits prevent context overflow
Filters unnecessary images (logos, lines, headers/footers)

Code

PDF Input
    ↓
Corruption Detection (pdfminer.six + pattern analysis)
    ↓
┌─────────────┬─────────────┐
│  Corrupted  │    Clean    │
│  → Image    │  → Text +   │
│    only     │    Tables + │
│             │    Images   │
└─────────────┴─────────────┘
    ↓
Ordered Blocks (JSON)

Install

Terminal

pip install pdf4vllm-mcp
# or run without installing
uvx pdf4vllm-mcp

Claude Desktop Setup

bash

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

Or manually edit ~/Library/Application Support/Claude/claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "pdf4vllm": {
      "command": "/path/to/python",
      "args": ["/path/to/pdf4vllm-mcp/src/server.py"]
    }
  }
}

Claude Code Setup

Create .mcp.json in your project:

config.json

{
  "mcpServers": {
    "pdf4vllm": {
      "command": "uvx",
      "args": ["pdf4vllm-mcp"]
    }
  }
}

Tools

Tool	Description
`list_pdfs`	Find PDF files with glob filtering (`name_pattern`)
`read_pdf`	Extract PDF content as ordered blocks
`grep_pdf`	Search text in PDFs using pdfgrep (requires `pdfgrep` installed)

Extraction Modes

Mode	Description
`auto` (default)	Try text extraction → switch to image if corrupted
`text_only`	Text/tables only, no images
`image_only`	Render pages as images only

Output Format

config.json

{
  "pages": [
    {
      "page_number": 1,
      "content_blocks": [
        {"type": "text", "content": "..."},
        {"type": "table", "content": "| A | B |"},
        {"type": "image", "content": "[IMAGE_0]"}
      ]
    }
  ]
}

When text is corrupted:

config.json

{
  "page_number": 2,
  "content_blocks": [],
  "text_corrupted": true,
  "page_image": "[IMAGE_1]"
}

Configuration

config.json or environment variables:

config.json

{
  "max_pages_per_request": 10,
  "max_image_dimension": 842,
  "page_image_dpi": 100
}

server.ts

export PDF_MAX_PAGES=20
export PDF_PAGE_IMAGE_DPI=150

Test Server

Terminal

pip install pdf4vllm-mcp[test]
python test_server.py
# → http://localhost:8000

License

MIT

GitHub · PyPI

Related MCP Servers

View all in Developer Tools View all alternatives

Frequently Asked Questions about Pdf4vllm

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "pdf4vllm": { "command": "npx", "args": ["-y", "pdf4vllm"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/pdf4vllm?style=directory)](https://allmcps.com/mcp/pdf4vllm)

HTML Embed

<a href="https://allmcps.com/mcp/pdf4vllm"><img src="https://allmcps.com/api/badge/pdf4vllm?style=directory" alt="Pdf4vllm on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

0/4 checks healthy over the last 6h

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Pdf4vllm →Install in Claude Desktop Install in Cursor Install in VS Code

Pdf4vllm

PDF reader for vision LLMs. Auto-detects text corruption and switches to image mode.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "pdf4vllm": {
      "command": "npx",
      "args": [
        "-y",
        "pdf4vllm"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Documentation Overview

pdf4vllm

PDF reading MCP server optimized for vision LLMs.

한국어

문제

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

해결

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

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

설치

Terminal

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

Claude Desktop 설정

bash

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):

config.json

{
  "mcpServers": {
    "pdf4vllm": {
      "command": "/python/경로",
      "args": ["/pdf4vllm-mcp/경로/src/server.py"]
    }
  }
}

도구

도구	설명
`list_pdfs`	PDF 파일 찾기 (glob 패턴 `name_pattern` 지원)
`read_pdf`	PDF 내용 블록으로 추출
`grep_pdf`	PDF 내 텍스트 검색 (`pdfgrep` 설치 필요)

추출 모드

모드	설명
`auto` (기본)	텍스트 추출 시도 → 손상 감지 시 이미지로 전환
`text_only`	텍스트/표만 추출, 이미지 없음
`image_only`	페이지를 이미지로만 렌더링

Problem

Approach	Issue
Text extraction	Encoding corruption → garbage output, mixed text-image ordering
Image conversion	Token explosion (especially with many pages)

Solution

pdf4vllm assumes PDFs are messy.

Auto-detects text corruption → switches to image automatically
Preserves reading order (text → table → image blocks in sequence)
Page limits prevent context overflow
Filters unnecessary images (logos, lines, headers/footers)

Code

PDF Input
    ↓
Corruption Detection (pdfminer.six + pattern analysis)
    ↓
┌─────────────┬─────────────┐
│  Corrupted  │    Clean    │
│  → Image    │  → Text +   │
│    only     │    Tables + │
│             │    Images   │
└─────────────┴─────────────┘
    ↓
Ordered Blocks (JSON)

Install

Terminal

pip install pdf4vllm-mcp
# or run without installing
uvx pdf4vllm-mcp

Claude Desktop Setup

bash

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

Or manually edit ~/Library/Application Support/Claude/claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "pdf4vllm": {
      "command": "/path/to/python",
      "args": ["/path/to/pdf4vllm-mcp/src/server.py"]
    }
  }
}

Claude Code Setup

Create .mcp.json in your project:

config.json

{
  "mcpServers": {
    "pdf4vllm": {
      "command": "uvx",
      "args": ["pdf4vllm-mcp"]
    }
  }
}

Tools

Tool	Description
`list_pdfs`	Find PDF files with glob filtering (`name_pattern`)
`read_pdf`	Extract PDF content as ordered blocks
`grep_pdf`	Search text in PDFs using pdfgrep (requires `pdfgrep` installed)

Extraction Modes

Mode	Description
`auto` (default)	Try text extraction → switch to image if corrupted
`text_only`	Text/tables only, no images
`image_only`	Render pages as images only

Output Format

config.json

{
  "pages": [
    {
      "page_number": 1,
      "content_blocks": [
        {"type": "text", "content": "..."},
        {"type": "table", "content": "| A | B |"},
        {"type": "image", "content": "[IMAGE_0]"}
      ]
    }
  ]
}

When text is corrupted:

config.json

{
  "page_number": 2,
  "content_blocks": [],
  "text_corrupted": true,
  "page_image": "[IMAGE_1]"
}

Configuration

config.json or environment variables:

config.json

{
  "max_pages_per_request": 10,
  "max_image_dimension": 842,
  "page_image_dpi": 100
}

server.ts

export PDF_MAX_PAGES=20
export PDF_PAGE_IMAGE_DPI=150

Test Server

Terminal

pip install pdf4vllm-mcp[test]
python test_server.py
# → http://localhost:8000

License

MIT

GitHub · PyPI

Related MCP Servers

View all in Developer Tools View all alternatives

Frequently Asked Questions about Pdf4vllm

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "pdf4vllm": { "command": "npx", "args": ["-y", "pdf4vllm"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/pdf4vllm?style=directory)](https://allmcps.com/mcp/pdf4vllm)

HTML Embed

<a href="https://allmcps.com/mcp/pdf4vllm"><img src="https://allmcps.com/api/badge/pdf4vllm?style=directory" alt="Pdf4vllm on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

0/4 checks healthy over the last 6h

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Pdf4vllm →Install in Claude Desktop Install in Cursor Install in VS Code