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.2.tar.gz (68.0 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.2-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pdf_image_extractor_mcp-0.1.2.tar.gz
  • Upload date:
  • Size: 68.0 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.2.tar.gz
Algorithm Hash digest
SHA256 9c093b5459ce64d3acd2bad3be7cbf9d6b578cad91ad5f21c3f86764b94bb092
MD5 5a41b741d63fa4682a35f253767435a3
BLAKE2b-256 f1b307c9ba903f2ba26bb03c8cab2963f3e957e44bf4e878f7e5f70397659c14

See more details on using hashes here.

Provenance

The following attestation bundles were made for pdf_image_extractor_mcp-0.1.2.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.2-py3-none-any.whl.

File metadata

File hashes

Hashes for pdf_image_extractor_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e48fa828e64da9d7d2c1081c0989b9d58f4705ffc206d5f34e8b437fdb7d9255
MD5 d30b4a0707a8c6ac7e8cc1539a409163
BLAKE2b-256 43eae240b2a15134f8f778742073d5097e96bd614303987874c2258687dfcd5a

See more details on using hashes here.

Provenance

The following attestation bundles were made for pdf_image_extractor_mcp-0.1.2-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