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.
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 ToolSupports 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?
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?
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?
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?
What image formats are supported?
MetaTag Genie supports JPG, PNG, and HEIC image formats.
What metadata types can I write?
What metadata types can I write?
You can write Tags, Description, People (as keywords), and Location metadata.