io.github.joshmsimpson/exiftool

Name: io.github.joshmsimpson/exiftool
Author: joshmsimpson

编码与调试

by joshmsimpson

基于 ExifTool 读取、写入并移除 150+ 文件格式的 metadata，适合批量处理与清理。

GitHub

什么是 io.github.joshmsimpson/exiftool？

基于 ExifTool 读取、写入并移除 150+ 文件格式的 metadata，适合批量处理与清理。

README

MCP ExifTool Server

mcp-name: io.github.joshmsimpson/exiftool

An MCP (Model Context Protocol) server that provides access to ExifTool for reading, writing, and removing metadata from a wide range of file types.

Features

Read metadata from over 150 file formats
Write metadata to files with automatic backup creation
Remove metadata selectively or completely from files
Extract specific tags or retrieve all available metadata
Support for multiple metadata standards: EXIF, IPTC, XMP, GPS, and manufacturer-specific formats

Supported File Formats

Image Formats:

RAW Camera Formats: ARW, CR2, CR3, CRW, DNG, ERF, FFF, GPR, IIQ, K25, KDC, MEF, MRW, NEF, NRW, ORF, PEF, RAF, RAW, RW2, RWL, SR2, SRF, SRW, X3F
Raster Images: BMP, FLIF, GIF, HDR, HEIC, HEIF, JPEG, JPEG 2000, JXL, JXR, PCX, PGF, PNG, PPM, TIFF, WebP
Specialized Images: AVIF, BPG, DPX, EXR, FITS, FLIR, FPX, ICO, LFP, MIFF, PSD, PSP, QTIF, SVG

Video Formats:

Containers: 3GP, AVI, F4V, FLV, GLV, M2TS, MOV, MP4, MKV, MPEG, R3D, VOB, WebM, WTV
Other Video: DV, DVR-MS, INSV, LRV, MQV

Audio Formats:

Lossless: AIFF, FLAC, LA, OFR, PAC, WAV, WV
Lossy: AAC, APE, DSF, M4A, MP3, MPC, OGG, OPUS, RA, WMA

Document Formats:

Office: DOC, DOCX, XLSX, PPTX, XLS, KEY, NUMBERS, PAGES
Other Documents: PDF, EPS, RTF, TXT, XML, JSON
eBooks: EPUB, MOBI, AZW

Archive Formats:

7z, GZ, RAR, ZIP

Other Formats:

Fonts: AFM, OTF, PFA, TTF
And many more specialized formats

Prerequisites

ExifTool must be installed on your system. This MCP server is a wrapper that calls the ExifTool command-line tool.

Installing ExifTool

macOS:

bash

brew install exiftool

Ubuntu/Debian:

bash

sudo apt-get install libimage-exiftool-perl

Windows: Download from https://exiftool.org/

Verify installation:

bash

exiftool -ver

Installation

bash

pip install exiftool-mcp

Usage

With Claude Desktop

Add this to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "exiftool": {
      "command": "exiftool-mcp"
    }
  }
}

With Other MCP Clients

The server communicates via stdio and follows the Model Context Protocol specification.

Available Tools

`read_metadata`

Read metadata from a file using ExifTool.

Parameters:

file_path (required): Path to the file (absolute or relative)
tags (optional): Array of specific metadata tags to extract (e.g., ["DateTimeOriginal", "Make", "Model"])

Example:

json

{
  "file_path": "/path/to/image.jpg",
  "tags": ["DateTimeOriginal", "Make", "Model", "GPSLatitude", "GPSLongitude"]
}

`write_metadata`

Write or update metadata tags in a file using ExifTool. Creates a backup by default.

Parameters:

file_path (required): Path to the file (absolute or relative)
tags (required): Dictionary of metadata tags to write (e.g., {"Artist": "John Doe", "Copyright": "2025"})
overwrite_original (optional): If true, overwrites the original file without creating a backup. Default is false.

Example:

json

{
  "file_path": "/path/to/image.jpg",
  "tags": {
    "Artist": "John Doe",
    "Copyright": "2025",
    "Comment": "Beautiful sunset"
  },
  "overwrite_original": false
}

`remove_metadata`

Remove metadata from a file using ExifTool. Can remove all metadata or specific tags.

Parameters:

file_path (required): Path to the file (absolute or relative)
tags (optional): Array of specific metadata tags to remove (e.g., ["GPS*", "Comment"]). If not specified, all metadata is removed.
overwrite_original (optional): If true, overwrites the original file without creating a backup. Default is false.

Example:

json

{
  "file_path": "/path/to/image.jpg",
  "tags": ["GPS*", "Location*"],
  "overwrite_original": false
}

`list_supported_formats`

List all file formats supported by ExifTool.

Parameters: None

Examples

Reading all metadata from an image

code

Use the read_metadata tool with file_path: "photo.jpg"

Reading specific EXIF tags

code

Use the read_metadata tool with:
- file_path: "photo.jpg"
- tags: ["DateTimeOriginal", "Make", "Model", "LensModel"]

Writing metadata to a file

code

Use the write_metadata tool with:
- file_path: "photo.jpg"
- tags: {"Artist": "Jane Smith", "Copyright": "2025", "Rating": "5"}

Removing GPS data from a photo

code

Use the remove_metadata tool with:
- file_path: "photo.jpg"
- tags: ["GPS*"]

Removing all metadata from a file

code

Use the remove_metadata tool with:
- file_path: "photo.jpg"
(no tags specified removes all metadata)

Checking supported formats

code

Use the list_supported_formats tool

Development

Setup

bash

git clone https://github.com/joshmsimpson/exiftool_mcp.git
cd exiftool_mcp
pip install -e .

Running locally

bash

python -m exiftool_mcp.server

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

常见问题