What is MetaTag Genie?

MetaTag Genie is a macOS Stdio MCP service designed for writing image metadata to enhance Spotlight search. It allows AI agents and other applications to manage image metadata locally.

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs.

What image formats does MetaTag Genie support?

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

What types of metadata can MetaTag Genie write?

It supports tags, descriptions, people (as keywords), and location (as text).

How do I install MetaTag Genie?

You can install it globally via npm (npm install -g metatag-genie), using Smithery, or from source.

How do I run MetaTag Genie?

You can run it via npx (npx metatag-genie), in development mode (npm run start:dev), or in production mode (npm start).

How do I integrate MetaTag Genie with Cursor?

Create a .cursor/mcp.json file in your project root and add the configuration for MetaTagGenie.

What is the communication protocol used by MetaTag Genie?

It uses JSON-RPC 2.0 over Stdio.

What are the system requirements for MetaTag Genie?

Node.js 22.x LTS or higher is required. It also implicitly depends on exiftool-vendored.

How do I contribute to MetaTag Genie?

Fork the repository, create a feature branch, and submit a pull request. Ensure your code adheres to the coding standards and passes all CI checks.

How does MetaTag Genie integrate with UBOS?

MetaTag Genie enriches image data with metadata, making it accessible to AI agents within the UBOS ecosystem, enabling custom AI agent workflows that leverage image understanding and data integration.