Metatag Genie
About
Metatag Genie is an MCP (Model Context Protocol) server for macOS that writes image metadata to enhance Spotlight search. It communicates over Stdio and can be called by AI agents or other applications needing local image metadata management.
Details
- Author
- terryso
- GitHub stars
- 1
- Downloads
- 287
- Categories
- Other
Jump to
- Supports writing metadata to JPG, PNG, and HEIC images
- Writes tags, description, people (as keywords), and location (text)
- Written metadata is indexed by macOS Spotlight
- Uses ExifTool (managed automatically via exiftool-vendored)
- Communicates over Stdio with MCP-compliant JSON-RPC 2.0
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Metatag GenieCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via npm install -g metatag-genie and run metatag-genie, or run directly with npx metatag-genie. For integration in Cursor, create .cursor/mcp.json with the command npx -y metatag-genie. The server listens on Stdio and expects JSON-RPC 2.0 messages.
writeImageMetadata
Writes metadata (tags, description, people, location) to an image file.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"metatag genie": {
"MetaTagGenie": {
"command": "npx",
"args": [
"-y",
"metatag-genie"
]
}
}
}
}McpServers
{
"MetaTagGenie": {
"command": "npx",
"args": [
"-y",
"metatag-genie"
]
}
}MetaTag Genie
简介
MetaTag Genie 是一个 macOS Stdio MCP 服务，专为写入图片元数据以增强 Spotlight 搜索而设计。该服务可被 AI 代理或其他需要本地管理图片元数据的应用程序调用，通过标准输入输出（Stdio）与客户端通信，提供符合 MCP (Machine Comprehension Protocol) 规范的接口。
功能特性
- 通过 Stdio 暴露符合 MCP 规范的服务
- 提供 writeImageMetadata MCP Tool
- 支持向 JPG, PNG, HEIC 图片写入元数据
- 支持的元数据类型：
- 标签 (Tags)
- 描述 (Description)
- 人物 (People - 作为关键词)
- 地点 (Location - 文本)
- 写入的元数据可被 macOS Spotlight 搜索
系统要求
- Node.js 版本：Node.js 22.x LTS 或更高版本
- 隐含依赖：本项目使用 exiftool-vendored，它会自动管理 ExifTool 的依赖
安装
安装 Smithery
要自动将 MetaTag Genie 安装到 Claude Desktop，请使用 Smithery：
npx -y @smithery/cli install @terryso/metatag_genie --client claude
通过NPM安装（推荐）
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
