This MCP server provides a set of tools for working with image EXIF metadata. It can parse complete EXIF data from single images or batches, extract just GPS coordinates, rename files based on EXIF data, and generate KMZ photo tours for Google Earth. The available tools are: parse_exif for single-image analysis, parse_exif_batch for multi-image analysis, get_gps_coordinates to pull only GPS data, rename_by_exif to batch-rename files using EXIF fields, and create_photo_tour_kmz to produce a geotagged KMZ tour from a collection of photos. Each tool accepts a JSON payload specifying input paths or options, allowing you to tailor the output (GPS inclusion, inclusion of XMP/IPTC data, thumbnail handling, and more). The KMZ tour feature creates a KML-based tour with markers, paths, and optional thumbnails, suitable for viewing in Google Earth.

To use these tools, call the corresponding MCP action (parse_exif, parse_exif_batch, get_gps_coordinates, rename_by_exif, create_photo_tour_kmz) through your MCP client or Claude Desktop integration. For example, parse_exif can be invoked with a file path and a set of options to control which metadata types are included (gps, xmp, iptc, etc.). The create_photo_tour_kmz tool will generate a KMZ from your selected photos, with options to order by date, draw a path, include thumbnails, and decide whether to embed full-resolution images. The tools are designed to be composable: you can first extract GPS coordinates, then rename files based on EXIF data, and finally compile a KMZ tour of the renamed images.

Prerequisites:

• Node.js and npm installed on your system
• Access to the repository (clone locally or download)

Step-by-step installation:

1. Clone the repository: git clone https://github.com/your-organization/theaj42-tims-exif-mcp-server.git cd theaj42-tims-exif-mcp-server

2. Install dependencies: npm install

3. Verify installation and run locally (example):

   Start the MCP server (adjust path to your index.js)

   node /path/to/exif-mcp-server/index.js

4. Configure Claude Desktop or your MCP client to use the server: { "mcpServers": { "exif": { "command": "node", "args": ["/path/to/exif-mcp-server/index.js"] } } }

Notes:

• If you deploy in a different environment (uvx, docker, etc.), adjust the mcp_config accordingly.
• Ensure any external dependencies (e.g., image processing libraries) are installed and accessible.

Tips and common considerations:

• Ensure GPS data is enabled on your camera to maximize EXIF usefulness for GPS-based tours and renaming.
• When creating KMZ tours, monitor file sizes if you opt to include full-resolution images; thumbnails (default) keep tours lighter.
• The rename_by_exif tool supports templates; familiarize yourself with the available placeholders like {date}, {time}, {datetime}, {camera}, {model}, {location}, and {counter} to organize your library.
• If you encounter path or permissions errors, verify that the MCP server process has read/write access to the image files and the output directory.
• For batch operations, ensure all input file paths exist and are accessible by the server process.