🔮 Omnia Media MCP

Production-Grade Visual AI & Commercial Merchandising Model Context Protocol (MCP) Server for Claude Desktop, Claude Code, Cursor, and Autonomous Agentic Workflows.

💡 Overview

Omnia Media MCP bridges large language models and agentic coding environments with high-speed, sub-second visual diffusion pipelines. While standard LLMs can reason and write code, they lack native actuators for photorealistic image synthesis, subject extraction, and commercial asset merchandising.

This toolkit provides:

1. The MCP Server (omnia-media-mcp): Exposes native tool endpoints (generate_image, recreate_from_seed, remove_background, stage_product, batch_render_catalog) to Claude Desktop, Claude Code, and Cursor.

2. The Developer CLI (omnia-cli): A standalone terminal utility for automated batch rendering, asset extraction, and continuous testing in CI/CD pipelines.

3. Multi-Aspect Commercial Templates: Pre-configured aspect ratios and photorealistic commercial presets (Italian Carrara marble, Scandinavian Nordic oak, lush botanical spa, and cyber studio).

Related MCP server: Vertex AI Imagen MCP Server

⚡ Quick Start: Connecting to Claude Desktop

Add this to your claude_desktop_config.json:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "omnia-media": {
      "command": "npx",
      "args": ["-y", "omnia-media-mcp"],
      "env": {
        "RUNWARE_API_KEY": "your_runware_api_key_here"
      }
    }
  }
}

Restart Claude Desktop, and Claude will automatically discover the visual creation tools!

🛠️ MCP Tools Overview

💻 Developer CLI Usage

You can also run Omnia directly in your terminal:

# Generate image from prompt
npx omnia-cli generate "Luxury skincare bottle on black wet volcanic stone, morning sun, 8k"

# Recreate from an existing image seed
npx omnia-cli recreate "https://example.com/item.jpg" "Minimalist Nordic oak countertop with soft shadows"

# High-precision transparent cutout
npx omnia-cli remove-bg "https://example.com/product.jpg"

📐 Architecture & Performance

┌───────────────────────────────┐
│  Claude Desktop / Claude Code │
└───────────────┬───────────────┘
                │  MCP stdio Protocol (JSON-RPC)
┌───────────────▼───────────────┐
│       Omnia Media Server      │
│  - Parameter Validation (Zod) │
│  - Pipeline Preset Engine     │
└───────────────┬───────────────┘
                │  Sub-second Edge Dispatch
┌───────────────▼───────────────┐
│     Runware Inference Node    │
│  - FLUX.1 Schnell Tensor      │
│  - Alpha Matting (BiRefNet)   │
│  - Latent Inpainting          │
└───────────────────────────────┘

• Latency: Typical end-to-end round trip is 1.4s – 2.4s for full 1024×1024 renders.

• Cost Efficiency: Runs at raw edge compute rates (~$0.0025 per generation).

🤝 Contributing

Contributions from the open-source community are welcome!

1. Fork the repository.

2. Create your feature branch (git checkout -b feature/new-preset).

3. Commit your changes (git commit -m 'feat: add desert lighting preset').

4. Push to the branch (git push origin feature/new-preset).

5. Open a Pull Request.

📜 License

Distributed under the MIT License. See LICENSE for details.