Skip to main content
Glama
pdf-image-extractor-mcp

pdf-image-extractor-mcp

by maxrabin

PDF Image Extractor MCP Server

PyPI Python License: MIT CI Ruff

A Model Context Protocol (MCP) server that extracts images from PDF files. Run this locally to let LLMs access and analyze images embedded within your local PDF documents.

Quick Start

You can run this server directly using uvx (part of the uv toolkit). No manual installation required.

uvx pdf-image-extractor-mcp@latest

Related MCP server: PDF Reader MCP Server

Configuration

Claude Desktop app

To use this with the Claude Desktop app, add the following to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pdf-image-extractor": {
      "command": "uvx",
      "args": ["pdf-image-extractor-mcp@latest"]
    }
  }
}

Cursor

To add this to Cursor:

Install MCP Server

  1. Open Cursor Settings.

  2. Go to Features -> MCP.

  3. Click + Add New MCP Server.

  4. Enter the following:

    • Name: pdf-image-extractor

    • Type: stdio (or Command)

    • Command: uvx pdf-image-extractor-mcp@latest

VS Code

If you are using the MCP Extension for VS Code (or a compatible AI extension):

Install on VS Code

Create or edit .vscode/mcp.json in your project root:

{
  "mcpServers": {
    "pdf-image-extractor": {
      "command": "uvx",
      "args": ["pdf-image-extractor-mcp@latest"]
    }
  }
}

Claude Code (CLI)

To add this server to Claude Code:

claude mcp add pdf-image-extractor -- uvx pdf-image-extractor-mcp@latest

n8n

To use this with n8n:

Note: n8n typically connects to MCP servers via HTTP (SSE), not local commands (stdio). To use this server with n8n, you must run it behind a generic SSE adapter.

  1. Install the n8n-nodes-mcp community node in your n8n instance.

  2. Run this server wrapped in an SSE transport (using a tool like mcp-proxy or stdio-to-sse).

  3. Configure the n8n MCP Client node to point to your local SSE port (e.g., http://localhost:3000/sse).

Development

If you want to contribute or run from source, please see CONTRIBUTING.md.

Available Tools

1 tool
extract_pdf_imagesA

Extract images from a PDF file with pagination.

Works best when extracting small batches of images (e.g., 10) at a time. Returns a list of image contents and a summary message.

Inputs: pdf_full_path (required), max_images, start_index. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so no ambiguity between tools is possible.

    Naming Consistency5/5

    Single tool so naming pattern is trivially consistent.

    Tool Count2/5

    One tool for PDF image extraction is too few; the server would benefit from additional tools like listing pages, extracting text, or handling metadata.

    Completeness3/5

    The tool covers basic image extraction but lacks options for page selection, image format control, or handling of edge cases like password-protected PDFs.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers