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.3.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.3-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pdf_image_extractor_mcp-0.1.3.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.3.tar.gz
Algorithm Hash digest
SHA256 1abefe838cf82ad94c60fe5b06e9385ef3b0bb72042024c8674b76bf0ae50b85
MD5 407071f6e3527c21b42a485e10f08a13
BLAKE2b-256 4612b376608e20de51e96b351ce1cadc0b43e1e678d8932229eaf350b6a50684

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for pdf_image_extractor_mcp-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7aae5dc5f879a1940a6bac0bc6598c4aba8bbcc5dd395057511b4fbf8736122f
MD5 58d6b19057885d9e089a7fc816c0634e
BLAKE2b-256 42d639305140f48f59bed6993f2bfe03230ebb0cdeb319ec374511404d601613

See more details on using hashes here.

Provenance

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