MetaTag Genie logo

MetaTag Genie

by terryso

MetaTag Genie is a macOS Stdio MCP service designed to enhance Spotlight search by writing metadata to images. It can be invoked by AI agents or other applications needing local image metadata management.

View on GitHub

Last updated: N/A

What is MetaTag Genie?

MetaTag Genie is a macOS Stdio MCP (Machine Comprehension Protocol) service. It facilitates writing metadata to images (JPG, PNG, HEIC) to improve their discoverability via macOS Spotlight search. It exposes a service compliant with the MCP specification through Stdio, allowing AI agents and other applications to interact with it.

How to use MetaTag Genie?

MetaTag Genie can be installed via npm or Smithery. It's recommended to run it using npx metatag-genie. AI agents or other clients can then interact with the service via Stdio using JSON-RPC 2.0 protocol, sending requests like writeImageMetadata with the file path and metadata to be written. The service does not listen on network ports; it communicates solely through standard input/output.

Key features of MetaTag Genie

  • Exposes MCP-compliant service via Stdio

  • Provides writeImageMetadata MCP Tool

  • Supports writing metadata to JPG, PNG, and HEIC images

  • Supports Tags, Description, People (as keywords), and Location metadata types

  • Written metadata is searchable via macOS Spotlight

Use cases of MetaTag Genie

  • Enhancing image searchability in macOS Spotlight

  • Automated metadata tagging by AI agents

  • Integrating metadata writing into image processing workflows

  • Adding descriptive information to images for better organization

  • Enriching image data for machine learning applications

FAQ from MetaTag Genie

What is MCP?

MCP stands for Machine Comprehension Protocol. It's a protocol used for communication between applications and AI agents.

How do I install MetaTag Genie?

You can install it globally via npm (npm install -g metatag-genie) or using Smithery (npx -y @smithery/cli install @terryso/metatag_genie --client claude).

How do I run MetaTag Genie?

The recommended way is to use npx metatag-genie. This doesn't require global installation.

What image formats are supported?

MetaTag Genie supports JPG, PNG, and HEIC image formats.

What metadata types can I write?

You can write Tags, Description, People (as keywords), and Location metadata.