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

Debugging with MCP Inspector

Start the inspector: npx @modelcontextprotocol/inspector node dist/server.js
Connect to it with MCP Inspector using the STDIO transport
Call a tool, e.g., read-metadata with parameter:
{ "image": { "kind": "path", "path": "/path/to/image.jpg" } }
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

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

离线 MCP 服务器允许 LLM 或人类使用 exifr 库从图像中提取和分析元数据，无需外部工具即可支持各种图像格式和元数据段。

Related Resources

Reddit Discussion about this server

Related MCP Servers

WebPerfect MCP Server
splendasucks
A
security
A
license
A
quality
An intelligent MCP server with a fully automated batch pipeline for web-ready images. Features include noise reduction, auto levels/curves, JPEG artifact removal, 4K resizing, smart sharpening with shadow/highlight enhancement, and advanced WebP conversion.
Last updated -
5
MIT License
MCP Read Images
catalystneuro
-
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 -
8
MIT License
Smart Photo Journal MCP Server
Siddhant-K-code
A
security
A
license
A
quality
This MCP server aids users in searching and analyzing their photo library by location, labels, and people, offering functionalities like photo analysis and fuzzy matching for enhanced photo management.
Last updated -
21
MIT License
Base64 MCP Server
liuyazui
A
security
F
license
A
quality
A simple and efficient MCP server that provides Base64 encoding and decoding functionality for both text and images with support for Data URL format.
Last updated -
4
3

View all related MCP servers

exif-mcp

exif-mcp

Overview

Features

Installation

Usage

Claude Desktop

Starting the server

Available Tools

Debugging with MCP Inspector

Image Source Types

Development

Running Tests

Project Structure

Error Handling

License

Acknowledgements

Tools

Related Resources

Related MCP Servers

WebPerfect MCP Server

MCP Read Images

Smart Photo Journal MCP Server

Base64 MCP Server

New MCP Servers

MCP directory API