exif-mcp

by stass

38 250 downloads Not rated yet BSD-2-Clause
GitHub

About

MCP server to extract image metadata (EXIF, XMP, etc)

Details

License
BSD-2-Clause

Explore

- Local operation: Works completely offline with no remote network required
- Multiple segments: Extracts EXIF, GPS, XMP, ICC, IPTC, JFIF, and IHDR metadata
- Various input formats: Supports JPEG, TIFF, HEIC/AVIF, and PNG
- Flexible image sources: Read from file system, URLs, base64 data, or buffers
- Specialized tools: Get orientation, rotation info, GPS coordinates, and thumbnails

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 exif-mcp
    Command (node, npx, python, etc.)

    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

Install by cloning the repository, running npm install, and building with npm run build. For use with Claude Desktop, add an entry to claude_desktop_config.json with command: "node" and args: ["/path/to/exif-mcp/dist/server.js"]. The server can also be started with npm start or run in development mode with npm run dev. It uses StdioServerTransport and is compatible with any MCP client that supports STDIO transport.

read-metadata

Reads all or specified metadata segments

read-exif

Reads EXIF data specifically

read-xmp

Reads XMP data

read-icc

Reads ICC color profile data

read-iptc

Reads IPTC metadata

read-jfif

Reads JFIF segment data

read-ihdr

Reads IHDR segment data

orientation

Gets image orientation (1-8)

rotation-info

Gets rotation and flip information

gps-coordinates

Extracts GPS coordinates

thumbnail

Extracts embedded thumbnail

The following tools are provided by the server:

| Tool name | Description |
|-----------|-------------|
| read-metadata | Reads all or specified metadata segments |
| read-exif | Reads EXIF data specifically |
| read-xmp | Reads XMP data |
| read-icc | Reads ICC color profile data |
| read-iptc | Reads IPTC metadata |
| read-jfif | Reads JFIF segment data |
| read-ihdr | Reads IHDR segment data |
| orientation | Gets image orientation (1-8) |
| rotation-info | Gets rotation and flip information |
| gps-coordinates | Extracts GPS coordinates |
| thumbnail | Extracts embedded thumbnail |

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "exif-mcp": {
            "exif-mcp": {
                "command": "node",
                "args": [
                    "/path/to/exif-mcp/dist/server.js"
                ]
            }
        }
    }
}

McpServers

{
    "exif-mcp": {
        "command": "node",
        "args": [
            "/path/to/exif-mcp/dist/server.js"
        ]
    }
}

An MCP server that allows LLMs (or humans) to read image metadata on-demand, entirely offline. Based on the excellent exifr library it's exremely fast and does not rely on any external tools.

Usecases:
Analyze image metadata and visualize it
Perform analysis of your image library: what are my most used cameras? Lens distribution? Which dates of the week I take most pictures on? Most favorite locations?

  • Debugging image manipulation code.


Ths tool is used extensively by the reverse geolocation service PlaceSpotter for development and testing.

Overview

exif-mcp is a Model Context Protocol (MCP) server that provides tools for extracting various metadata segments from images. Built with TypeScript, it leverages the excellent exifr library to parse metadata from images in common formats like JPEG, PNG, TIFF, and HEIC. This allows this service to parse image metadata without executing any external tools which allows it to be both highly efficient and secure.

Features

- Local operation: Works completely offline with no remote network required
- Multiple segments: Extracts EXIF, GPS, XMP, ICC, IPTC, JFIF, and IHDR metadata
- Various input formats: Supports JPEG, TIFF, HEIC/AVIF, and PNG
- Flexible image sources: Read from file system, URLs, base64 data, or buffers
- Specialized tools: Get orientation, rotation info, GPS coordinates, and thumbnails

Installation

```csh

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.