Image Extractor

by ifmelate

14 stars
579 downloads
Not rated
GitHub

About

Enables image processing and analysis by extracting images from URLs or base64 data, with features for resizing, format conversion, and secure domain filtering.

Details

Author
ifmelate
Repository
ifmelate/mcp-image-extractor
GitHub stars
14
Downloads
579
License
MIT License
Categories
Developer Tools, AI, Productivity, Design, Media, Security, Infrastructure
Tags
#web

- Extract images from local file paths
- Extract images from remote URLs
- Process base64-encoded image data
- Automatic resizing to maximum 512x512 pixels
- Easy one-line install with npx
- Docker support for containerized deployments

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Image Extractor
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 mcp-image-extractor

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

If you prefer to use a local installation of the package, you can clone the repository and point to the built files:

{
  "mcpServers": {
    "image-extractor": {
      "command": "node",
      "args": ["/full/path/to/mcp-image-extractor/dist/index.js"],
      "disabled": false
    }
  }
}

git clone https://github.com/ifmelate/mcp-image-extractor.git
cd mcp-image-extractor
npm install
npm run build
npm link

This will make the mcp-image-extractor command available globally.

Then configure in .cursor/mcp.json:

{
  "mcpServers": {
    "image-extractor": {
      "command": "mcp-image-extractor",
      "disabled": false
    }
  }
}

> Troubleshooting for Cursor Users: If you see "Failed to create client" error, try the local path installation method above or ensure you're using the correct path to the executable.

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.

extract_image_from_url

Extracts an image from a URL and converts it to base64. Parameters: url (required): URL of the image to extract.

extract_image_from_base64

Processes a base64-encoded image for LLM analysis. Parameters: base64 (required): Base64-encoded image data, mime_type (optional, default: 'image/png'): MIME type of the image.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "image extractor": {
            "cwd": null,
            "env": {},
            "args": [
                "-y",
                "mcp-image-extractor"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Linux

{
    "cwd": null,
    "env": [],
    "args": [
        "-y",
        "mcp-image-extractor"
    ],
    "shell": false,
    "command": "npx"
}

Macos

{
    "cwd": null,
    "env": [],
    "args": [
        "-y",
        "mcp-image-extractor"
    ],
    "shell": false,
    "command": "npx"
}

Windows

{
    "cwd": null,
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "mcp-image-extractor"
    ],
    "shell": false,
    "command": "cmd"
}

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

- analyze playwright test results: screenshots

Recommended: Using npx in mcp.json (Easiest)

The recommended way to install this MCP server is using npx directly in your.cursor/mcp.jsonfile:

{ "mcpServers": { "image-extractor": { "command": "npx", "args": [ "-y", "mcp-image-extractor" ] } } }

- Automatically installs the latest version
- Does not require global installation
- Works reliably across different environments

If you prefer to use a local installation of the package, you can clone the repository and point to the built files:

{ "mcpServers": { "image-extractor": { "command": "node", "args": ["/full/path/to/mcp-image-extractor/dist/index.js"], "disabled": false } } }
# Clone and install git clone https://github.com/ifmelate/mcp-image-extractor.git cd mcp-image-extractor npm install npm run build npm link

This will make themcp-image-extractorcommand available globally.

{ "mcpServers": { "image-extractor": { "command": "mcp-image-extractor", "disabled": false } } }

Troubleshooting for Cursor Users: If you see "Failed to create client" error, try the local path installation method above or ensure you're using the correct path to the executable.

Extracts an image from a local file and converts it to base64.

- 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.

Extracts an image from a URL and converts it to base64.

- 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.

Processes a base64-encoded image for LLM analysis.

- base64(required): Base64-encoded image data
- mime_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.

Here's an example of how to use the tools from Claude:

Please extract the image from this local file: images/photo.jpg

Claude will automatically use theextract_image_from_filetool to load and analyze the image content.

Please extract the image from this URL: https://example.com/image.jpg

Claude will automatically use theextract_image_from_urltool to fetch and analyze the image content.

docker build -t mcp-image-extractor . docker run -p 8000:8000 mcp-image-extractor

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

next-devtools-mcp is a MCP server that provides Next.js development tools and utilities for AI coding assistants like Claude and Cursor.

Word search, crossword, and sudoku generator MCP server with printable PDF worksheets, themed word banks, and verifiable LLM evals. Local-first, from the makers of puzzletide.com.

A demonstration server for ActionKit, providing access to Slack actions via Claude Desktop.

MCP server that lets Claude Code agents delegate tasks to agents in other project directories, with parallel dispatch, sessions, and async jobs.

Statistical regression testing for LLM agents: p-value, effect size, and CI on behavior change.

A Python MCP package that gives your LLM agents complete file system and shell capabilities — production-ready, sandboxed, and wired to any LLM in minutes.

Integrates with Google AI Studio/Gemini API for PDF to Markdown conversion and content generation.

Anchor Browser (https://anchorbrowser.io) is secure infrastructure for computer-use agents — stealth cloud browsers, authentication, captcha bypass, and a hosted MCP server for Cursor, Claude, and Windsurf.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.