exif-mcp
The exif-mcp server allows you to extract and analyze metadata from images entirely offline, without requiring network access. You can:
Extract all or specific metadata segments (EXIF, GPS, XMP, ICC, IPTC, JFIF, IHDR)
Get image orientation values (1-8) and detailed rotation/flip information
Extract GPS coordinates (latitude and longitude)
Extract embedded thumbnails as base64 data or URLs
Process images from multiple sources: file paths, URLs, base64 data, or buffers
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.
Available as an npm package with commands for installation, building, testing, and running the server in development mode with auto-reload.
Built with TypeScript, providing type-safe interfaces for extracting and processing image metadata across various formats.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@exif-mcp read the EXIF data from my vacation photo at /photos/hawaii.jpg"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: mcp-video
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 buildUsage
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 devThe 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 |
| Reads all or specified metadata segments |
| Reads EXIF data specifically |
| Reads XMP data |
| Reads ICC color profile data |
| Reads IPTC metadata |
| Reads JFIF segment data |
| Reads IHDR segment data |
| Gets image orientation (1-8) |
| Gets rotation and flip information |
| Extracts GPS coordinates |
| Extracts embedded thumbnail |
Debugging with MCP Inspector
Start the inspector:
npx @modelcontextprotocol/inspector node dist/server.jsConnect to it with MCP Inspector using the STDIO transport
Call a tool, e.g.,
read-metadatawith 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:watchProject 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.mdError 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
Available Tools
11 toolsgps-coordinatesB
Extract GPS coordinates (latitude/longitude) from image metadata
Inputs: image (required).
orientationB
Get image orientation value (1-8)
Inputs: image (required).
read-exifB
Read EXIF data from an image with optional tag filtering
Inputs: image (required), pick.
read-iccC
Read ICC metadata from an image
Inputs: image (required).
read-ihdrB
Read IHDR metadata from an image
Inputs: image (required).
read-iptcB
Read IPTC metadata from an image
Inputs: image (required).
read-jfifC
Read JFIF metadata from an image
Inputs: image (required).
read-metadataC
Read all or specified metadata segments from an image
Inputs: image (required), segments.
read-xmpA
Read XMP metadata from an image with option for extended XMP segments
Inputs: image (required), extended.
rotation-infoB
Get detailed rotation and flip information from image orientation
Inputs: image (required).
thumbnailB
Extract embedded thumbnail from image as base64 data or URL
Inputs: image (required), url.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools have clearly distinct purposes focused on different metadata types (EXIF, ICC, IHDR, IPTC, JFIF, XMP, GPS, orientation, thumbnail), but there is some overlap between 'read-exif' and 'read-metadata' since EXIF is a type of metadata, which could cause mild confusion. The 'orientation' and 'rotation-info' tools also cover similar ground, though with different detail levels.
Tool names follow a highly consistent verb-noun pattern with 'read-' prefixes for metadata extraction tools (e.g., read-exif, read-icc, read-ihdr) and descriptive names for other functions (e.g., gps-coordinates, orientation, thumbnail). All names use kebab-case consistently, making them predictable and easy to parse.
With 11 tools, the server is well-scoped for extracting various types of image metadata, covering common formats like EXIF, ICC, and XMP, as well as specific functions like GPS and thumbnails. Each tool appears to serve a distinct purpose without unnecessary duplication, fitting the domain appropriately.
The tool set provides comprehensive coverage for reading and extracting image metadata, including all major standards (EXIF, ICC, IHDR, IPTC, JFIF, XMP) and practical utilities (GPS coordinates, orientation, thumbnails). There are no obvious gaps for the server's purpose, as it supports both broad and specific metadata access without dead ends.
Maintenance
Related MCP Connectors
MCP server for Qwen Image 3 AI image generation
MCP server for Flux AI image generation
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Related MCP Servers
- AlicenseAqualityAmaintenanceManage your self-hosted Immich photo library through conversation — natural language search via CLIP, geographic album curation, duplicate detection with perceptual hashing,94223 PyPI62MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables LLMs to analyze video content by extracting frames as base64 images and retrieving video metadata using ffmpeg.5 npmMIT
- AlicenseAqualityDmaintenanceMCP server providing image analysis tools for AI agents, including metadata extraction, favicon discovery, and placeholder generation.543 npmMIT
- AlicenseNot gradedqualityDmaintenanceA local Ollama-backed MCP server that gives coding assistants a portable photo-understanding toolset including photo analysis, OCR, scene inspection, comparison, and metadata extraction.MIT