npm install

cp .env.example .env

SUPABASE_URL=https://your-project-id.supabase.co
SUPABASE_ANON_KEY=your_anon_key_here
SUPABASE_BUCKET_NAME=your_storage_bucket_name

npm run build
npm start

{
  "mcpServers": {
    "image-metadata-embed-and-report": {
      "command": "node",
      "args": ["/path/to/your/image-metadata-embed-and-report/dist/server.js"],
      "env": {
        "SUPABASE_URL": "https://your-project-id.supabase.co",
        "SUPABASE_ANON_KEY": "your_anon_key_here",
        "SUPABASE_BUCKET_NAME": "your_storage_bucket_name"
      },
      "description": "Image Metadata Embed and Report - XMP metadata with beautiful formatting"
    }
  }
}

Lifestyle marketing potential emotional hooks: Comfort, Pleasure, Well-being
Product physical characteristics primary color: Silver/Gray

emotional hooks    : Comfort, Pleasure, Well-being
primary color      : Silver/Gray

--- Raw JSON ---
{"lifestyle_marketing_potential_emotional_hooks": "Comfort, Pleasure, Well-being", ...}

# Input → Output
restaurant_scene.png → restaurant_scene_me.jpg
product_photo.tiff → product_photo_me.jpg
folder/image.png → folder/image_me.jpg

{
  "source_path": "images/restaurant_scene.png",
  "metadata": {
    "scene_overview": {
      "setting": "Outdoor restaurant patio",
      "time_of_day": "Evening"
    },
    "human_elements": {
      "number_of_people": 8,
      "social_dynamics": "Friends enjoying dinner"
    },
    "marketing_potential": {
      "emotional_hooks": ["Social connection", "Relaxed dining"]
    }
  },
  "output_path": "processed/restaurant_scene.png",
  "schema_type": "lifestyle"
}

{
  "image_path": "processed/restaurant_scene_me.jpg",
  "format": "formatted",
  "include_xmp": true
}

setting           : Outdoor restaurant patio
time of day       : Evening
number of people  : 8
social dynamics   : Friends enjoying dinner
emotional hooks   : Social connection, Relaxed dining

--- Raw JSON ---
{"lifestyle_scene_overview_setting": "Outdoor restaurant patio", ...}

{
  "metadata": {
    "product_identification": {
      "product_type": "Console Table",
      "design_style": "Minimalist"
    }
  },
  "schema_type": "product",
  "strict_mode": false
}

{
  "metadata": {
    "scene_overview": {
      "setting": "Modern office",
      "activities": ["Working", "Collaboration"]
    }
  },
  "output_path": "metadata/office_scene.xmp",
  "pretty_print": true
}

{
  "image_path": "processed/restaurant_scene_me.jpg",
  "format": "detailed",
  "include_raw_json": true
}

🎯 TYPE OF ANALYSIS COMPLETED: LIFESTYLE
Categories Found: 8 | Total Fields: 14 | Processing Time: 4.2ms

📊 SCENE OVERVIEW
-----------------------------------------------------------------
Setting         : Elegant restaurant interior
Time Of Day     : Evening

👥 HUMAN ELEMENTS
-----------------------------------------------------------------
Number Of People: 6
Social Dynamics : Family celebration dinner

[... other organized categories ...]

=================================================================
RAW JSON DATA (Machine Readable)
=================================================================
{...complete metadata...}

simple-orbit-mcp/
├── src/
│   ├── server.ts              # Main MCP server
│   ├── core/
│   │   ├── supabase-client.ts # Stream-based storage client
│   │   ├── xmp-processor.ts   # XMP creation and embedding
│   │   └── metadata-validator.ts # Schema validation
│   ├── tools/
│   │   ├── embed-metadata.ts  # Embedding tool
│   │   ├── read-metadata.ts   # Reading tool
│   │   ├── validate-schema.ts # Validation tool
│   │   ├── create-xmp.ts      # XMP creation tool
│   │   └── create-metadata-report.ts # NEW! Category-based reports
│   └── types/
│       └── schemas.ts         # TypeScript interfaces
└── dist/                      # Compiled JavaScript

npm run build     # Compile TypeScript
npm run watch     # Watch for changes
npm run dev       # Development mode with tsx

# Required environment variables
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your_anon_key_here

# Optional: Use service role key for enhanced permissions
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# 1. Validate lifestyle metadata
validate_metadata_schema({
  "metadata": {
    "scene_overview": { "setting": "Coffee shop", "time_of_day": "Morning" },
    "human_elements": { "number_of_people": 2, "social_dynamics": "Business meeting" }
  },
  "schema_type": "lifestyle"
})

# 2. Embed into image
embed_image_metadata({
  "source_path": "uploads/coffee_meeting.jpg",
  "metadata": { /* lifestyle metadata */ },
  "output_path": "processed/coffee_meeting_analyzed.jpg"
})

# 3. Verify embedding
read_image_metadata({
  "image_path": "processed/coffee_meeting_analyzed.jpg",
  "format": "json"
})

# 1. Create XMP packet for product
create_xmp_packet({
  "metadata": {
    "product_identification": { "product_type": "Office Chair", "design_style": "Ergonomic" },
    "commercial_analysis": { "target_market": ["Businesses", "Home offices"] }
  },
  "schema_type": "product",
  "output_path": "metadata/office_chair.xmp"
})

# 2. Embed into product image
embed_image_metadata({
  "source_path": "catalog/chair_001.jpg",
  "metadata": { /* product metadata */ },
  "output_path": "catalog/processed/chair_001_metadata.jpg"
})

# 1. Generate detailed categorized report
create_metadata_report({
  "image_path": "processed/restaurant_celebration_me.jpg",
  "format": "detailed",
  "include_raw_json": true
})

# Output: Organized report with category headers:
# 🎯 TYPE OF ANALYSIS COMPLETED: LIFESTYLE
# 📊 SCENE OVERVIEW | 👥 HUMAN ELEMENTS | 🌍 ENVIRONMENT
# 🍽️ KEY OBJECTS | 🌅 ATMOSPHERIC ELEMENTS | etc.

# 2. Generate simple summary report for quick review
create_metadata_report({
  "image_path": "catalog/chair_001_me.jpg",
  "format": "simple"
})

# Output: Condensed report showing key fields by category
# Analysis: PRODUCT (6 categories, 13 fields)

# 3. Generate JSON-only report for API integration
create_metadata_report({
  "image_path": "orbit/workspace_me.jpg", 
  "format": "json-only"
})