MCP Image Extractor
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Supports containerized deployment of the MCP image extraction service through Docker, allowing for isolated and portable execution environments.
Provides installation directly from GitHub repository, with specific instructions for cloning and building from the GitHub source.
Enables installation and management through npm, with support for npm link to make the command globally available.
MCP Image Extractor
MCP server for extracting and converting images to base64 for LLM analysis.
This MCP server provides tools for AI assistants to:
- Extract images from local files
- Extract images from URLs
- Process base64-encoded images
How it looks in Cursor:
Suitable cases:
- analyze playwright test results: screenshots
For Cursor or Other Clients
Manual Installation
This will make the mcp-image-extractor
command available globally.
Using .cursor/mcp.json file
For local development or when working in a specific project, you can add a .cursor/mcp.json
file in your project root:
Or, if you've installed via npm link:
Important Note for Cursor Users: If you see "Failed to create client" error, try these alternatives:
Option 1: Use direct GitHub installation
CopyThen configure in
.cursor/mcp.json
:CopyOption 2: Clone and run locally
CopyThen configure in
.cursor/mcp.json
:Copy
Available Tools
extract_image_from_file
Extracts an image from a local file and converts it to base64.
Parameters:
file_path
(required): Path to the local image file
Note: All images are automatically resized to optimal dimensions (max 512x512) for LLM analysis to limit the size of the base64 output and optimize context window usage.
extract_image_from_url
Extracts an image from a URL and converts it to base64.
Parameters:
url
(required): URL of the image to extract
Note: All images are automatically resized to optimal dimensions (max 512x512) for LLM analysis to limit the size of the base64 output and optimize context window usage.
extract_image_from_base64
Processes a base64-encoded image for LLM analysis.
Parameters:
base64
(required): Base64-encoded image datamime_type
(optional, default: "image/png"): MIME type of the image
Note: All images are automatically resized to optimal dimensions (max 512x512) for LLM analysis to limit the size of the base64 output and optimize context window usage.
Example Usage
Here's an example of how to use the tools from Claude:
Claude will automatically use the extract_image_from_file
tool to load and analyze the image content.
Claude will automatically use the extract_image_from_url
tool to fetch and analyze the image content.
Docker
Build and run with Docker:
License
MIT
You must be authenticated.
A Model Context Protocol server that extracts images from URLs or base64 data and converts them into a format suitable for LLM analysis, allowing AI models to process and understand visual content.