Image Extractor

🚀 Image Extractor MCP Server

Provide tools for AI assistants to extract and convert images from local files, URLs, and base64-encoded images for LLM analysis.

This MCP server offers the following features:

• Extract images from local files.
• Extract images from URLs.
• Process base64-encoded images.

The display effect in Cursor is as follows:

Applicable Scenarios

• Analyze Playwright test results: screenshots.

🚀 Quick Start

Configuration using the .cursor/mcp.json file

For local development or specific projects, you can add a .cursor/mcp.json file to the project root directory:

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

Alternatively, if you have installed via npm link:

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

⚠️ Important Note (for Cursor users)

If you encounter the error "Failed to create client", try the following alternatives:

Option 1: Install directly from GitHub

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

Then configure in .cursor/mcp.json:

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

Option 2: Clone and run locally

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

Then configure in .cursor/mcp.json:

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

✨ Features

Available Tools

extract_image_from_file

Extract an image from a local file and convert it to base64 encoding.

Parameters:

• file_path (required): The path to the local image file.

Note: All images are automatically output in base64-encoded format, suitable for use in environments that require encoding.

extract_image_from_url

Extract an image from a URL and convert it to base64 encoding.

Parameters:

• url (required): The URL containing the image to be extracted.

Note: Please ensure that the URL you provide is valid and accessible. An invalid or inaccessible URL may result in an error.

extract_image_from_base64

Decode a base64-encoded string into an image file.

Parameters:

• base64_string (required): The base64-encoded string to be converted.

Note: This tool only accepts valid base64 strings. An invalid input may result in an error.

🔧 Technical Details

Docker Configuration

Build and run using Docker:

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

Access http://localhost:8000 to check the service status.

📄 License

MIT