MCP server for extracting images from PDFs
Project description
PDF Image Extractor MCP Server
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:
- Open Cursor Settings.
- Go to Features -> MCP.
- Click + Add New MCP Server.
- Enter the following:
- Name:
pdf-image-extractor - Type:
stdio(or Command) - Command:
uvx pdf-image-extractor-mcp@latest
- Name:
VS Code
If you are using the MCP Extension for VS Code (or a compatible AI extension):
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.
- Install the n8n-nodes-mcp community node in your n8n instance.
- Run this server wrapped in an SSE transport (using a tool like
mcp-proxyorstdio-to-sse). - 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b5d60def656583767c423593839789d6c14320ca0bf5ccab2e06992068641174
|
|
| MD5 |
d9a38d3b3873322dcfd7a52617701640
|
|
| BLAKE2b-256 |
ad1eaba0a7d0267f826a5843dc6dc8dd727c7d011cec4eb14370d971974216d5
|
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
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pdf_image_extractor_mcp-0.1.4.tar.gz -
Subject digest:
b5d60def656583767c423593839789d6c14320ca0bf5ccab2e06992068641174 - Sigstore transparency entry: 774222495
- Sigstore integration time:
-
Permalink:
maxrabin/pdf-image-mcp@5f10cd55ef4781135831104a700b05cdf612dd8a -
Branch / Tag:
refs/tags/v0.1.5 - Owner: https://github.com/maxrabin
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@5f10cd55ef4781135831104a700b05cdf612dd8a -
Trigger Event:
release
-
Statement type:
File details
Details for the file pdf_image_extractor_mcp-0.1.4-py3-none-any.whl.
File metadata
- Download URL: pdf_image_extractor_mcp-0.1.4-py3-none-any.whl
- Upload date:
- Size: 6.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6b0dd7ba487cc6606a98a50227ddd2707b128df24855bdc13920dc1ebb404da1
|
|
| MD5 |
58986036f4820c731e6671023441675e
|
|
| BLAKE2b-256 |
e0f91d10d13dfb80e02bad03b6698ae5f6df5d8c8c8814c3f4eb43f5e228a928
|
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
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pdf_image_extractor_mcp-0.1.4-py3-none-any.whl -
Subject digest:
6b0dd7ba487cc6606a98a50227ddd2707b128df24855bdc13920dc1ebb404da1 - Sigstore transparency entry: 774222496
- Sigstore integration time:
-
Permalink:
maxrabin/pdf-image-mcp@5f10cd55ef4781135831104a700b05cdf612dd8a -
Branch / Tag:
refs/tags/v0.1.5 - Owner: https://github.com/maxrabin
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@5f10cd55ef4781135831104a700b05cdf612dd8a -
Trigger Event:
release
-
Statement type: