exif-mcp

by stass
BSD 2-Clause "Simplified" License

Integrations

  • Licensed under BSD 2-clause, allowing users to modify and distribute the software under the terms of this permissive license.

  • Hosted on GitHub where users can clone the repository to install and use the exif-mcp server.

  • Extracts EXIF, GPS, XMP, ICC, IPTC, JFIF metadata from JPEG images, providing tools for analyzing orientation, rotation info, GPS coordinates, and thumbnails.

exif-mcp

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

# Clone the repository git clone https://github.com/stass/exif-mcp.git cd exif-mcp # Install dependencies npm install # Build the project npm run build

Usage

Claude Desktop

Put this into Claude config file (claude_desktop_config.json):

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

Restart Claude. Now you can ask Claude to inspect images for you or e.g. find files taken with specific camera. This works best in combination with filesystem MCP tools so Claude can find files and list directories.

Starting the server

# Start the server npm start # For development with auto-reload npm run dev

The server uses the StdioServerTransport from the MCP SDK, making it compatible with any MCP client that supports STDIO transport.

You can use mcp-proxy to enable remote access.

Available Tools

The following tools are provided by the server:

Tool nameDescription
read-metadataReads all or specified metadata segments
read-exifReads EXIF data specifically
read-xmpReads XMP data
read-iccReads ICC color profile data
read-iptcReads IPTC metadata
read-jfifReads JFIF segment data
read-ihdrReads IHDR segment data
orientationGets image orientation (1-8)
rotation-infoGets rotation and flip information
gps-coordinatesExtracts GPS coordinates
thumbnailExtracts embedded thumbnail

Debugging with MCP Inspector

  1. Start the inspector: npx @modelcontextprotocol/inspector node dist/server.js
  2. Connect to it with MCP Inspector using the STDIO transport
  3. Call a tool, e.g., read-metadata with parameter:
    { "image": { "kind": "path", "path": "/path/to/image.jpg" } }
  4. You cal also use MCP inspector command line like this: npx @modelcontextprotocol/inspector --cli node dist/server.js --method tools/call --tool-name read-exif --tool-arg image='{"kind": "path", "path": "/path/to/image.jpeg"}' --tool-arg pick="[]"

Image Source Types

The server supports multiple ways to provide image data:

// From local file system { "kind": "path", "path": "/path/to/image.jpg" } // From URL (http, https, or file://) { "kind": "url", "url": "https://example.com/image.jpg" } // From base64 data (raw or data URI) { "kind": "base64", "data": "data:image/jpeg;base64,/9j/4AAQSkZ..." } // From base64 buffer { "kind": "buffer", "buffer": "/9j/4AAQSkZ..." }

Development

Running Tests

# Run tests npm test # Run tests with watch mode npm run test:watch

Project Structure

exif-mcp/ ├── src/ │ ├── server.ts # Main entry point │ ├── tools/ │ │ ├── index.ts # Tool registration │ │ ├── loaders.ts # Image loading utilities │ │ └── segments.ts # exifr options builders │ └── types/ │ └── image.ts # Type definitions ├── tests/ # Test files └── README.md

Error Handling

The server provides standardized error handling for common issues:

  • Unsupported formats or missing metadata
  • Network fetch failures
  • Oversized payloads
  • Internal exifr errors

License

BSD 2-clause

Acknowledgements

  • exifr - Extremely fast and robust EXIF parsing library

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

An offline MCP server that allows LLMs or humans to extract and analyze metadata from images using the exifr library, supporting various image formats and metadata segments without external tools.

  1. Overview
    1. Features
  2. Installation
    1. Usage
      1. Claude Desktop
      2. Starting the server
      3. Available Tools
      4. Debugging with MCP Inspector
      5. Image Source Types
    2. Development
      1. Running Tests
      2. Project Structure
    3. Error Handling
      1. License
        1. Acknowledgements

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            An MCP server for analyzing images using OpenRouter vision models, offering capabilities like automatic image resizing, model configuration, and handling custom queries about images.
            Last updated -
            5
            JavaScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            Image Tools MCP is a Model Context Protocol (MCP) service that retrieves image dimensions and compresses images from URLs and local files using the TinyPNG API. It supports converting images to formats like webp, jpeg/jpg, and png, providing detailed information on width, height, type, and compressi
            Last updated -
            4
            11
            3
            JavaScript
            MIT License
            • Apple
          • A
            security
            F
            license
            A
            quality
            A MCP server that allows searching for files in the filesystem based on path fragments, returning file metadata including name, path, size, and creation date.
            Last updated -
            1
            Python
            • Apple
          • -
            security
            A
            license
            -
            quality
            MCP server that enables LLMs to interact with Tripadvisor API, supporting location data, reviews, and photos through standardized MCP interfaces
            Last updated -
            Python
            MIT License
            • Linux
            • Apple

          View all related MCP servers

          ID: 5hxbqhlnlk