Skip to main content

MCP server for extracting images from PDFs

Project description

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

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pdf_image_extractor_mcp-0.1.4.tar.gz (69.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pdf_image_extractor_mcp-0.1.4-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file pdf_image_extractor_mcp-0.1.4.tar.gz.

File metadata

  • Download URL: pdf_image_extractor_mcp-0.1.4.tar.gz
  • Upload date:
  • Size: 69.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pdf_image_extractor_mcp-0.1.4.tar.gz
Algorithm Hash digest
SHA256 b5d60def656583767c423593839789d6c14320ca0bf5ccab2e06992068641174
MD5 d9a38d3b3873322dcfd7a52617701640
BLAKE2b-256 ad1eaba0a7d0267f826a5843dc6dc8dd727c7d011cec4eb14370d971974216d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for pdf_image_extractor_mcp-0.1.4.tar.gz:

Publisher: release.yml on maxrabin/pdf-image-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pdf_image_extractor_mcp-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for pdf_image_extractor_mcp-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 6b0dd7ba487cc6606a98a50227ddd2707b128df24855bdc13920dc1ebb404da1
MD5 58986036f4820c731e6671023441675e
BLAKE2b-256 e0f91d10d13dfb80e02bad03b6698ae5f6df5d8c8c8814c3f4eb43f5e228a928

See more details on using hashes here.

Provenance

The following attestation bundles were made for pdf_image_extractor_mcp-0.1.4-py3-none-any.whl:

Publisher: release.yml on maxrabin/pdf-image-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page