Diana MCP

Diana is an AI stylist that creates "Shop the Look" outfits for Shopify stores. This package connects Diana to Claude via the Model Context Protocol.

Prerequisites

1. Install the Katalogo Shopify app on your store
2. Analyze your catalog — the app scans your products and builds a style profile
3. Get an API key from Shopify Admin > Apps > Katalogo > Settings > API Keys

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "diana": {
      "command": "npx",
      "args": ["-y", "diana-mcp"],
      "env": {
        "DIANA_API_KEY": "diana_sk_your_key_here"
      }
    }
  }
}

Claude Code

Add to your project's .claude/mcp_settings.json or global settings:

{
  "mcpServers": {
    "diana": {
      "command": "npx",
      "args": ["-y", "diana-mcp"],
      "env": {
        "DIANA_API_KEY": "diana_sk_your_key_here"
      }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "diana": {
      "command": "npx",
      "args": ["-y", "diana-mcp"],
      "env": {
        "DIANA_API_KEY": "diana_sk_your_key_here"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | diana_get_store_profile | Get catalog overview — product count, gender distribution, top categories, quota usage | | diana_list_analyzed_products | Browse products with AI enrichment data — filter by gender, type, occasion, search | | diana_plan_outfits | Plan a diverse outfit portfolio with commercial goals, style direction, and occasion targeting | | diana_generate_outfits | Generate outfits from a plan (or simple params). Returns a task ID for polling | | diana_get_task_status | Poll generation progress until complete |

Example Prompts

• "Show me my store profile and what products are available"
• "Plan 10 winter outfits focused on cross-selling jackets"
• "Create 5 casual weekend outfits for women"
• "List all analyzed products under $100"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | DIANA_API_KEY | Yes | Your API key from the Katalogo Shopify app | | DIANA_MCP_ENDPOINT | No | Custom endpoint URL (for self-hosted setups) |

How It Works

This package is a thin stdio-to-HTTP proxy with zero runtime dependencies. Claude communicates via MCP's stdio protocol, and this proxy forwards requests to Diana's hosted API with your authentication.

Claude (stdio) → diana-mcp (proxy) → Diana API (HTTPS) → Your Shopify store

All outfit generation logic, catalog analysis, and Shopify sync runs server-side. The proxy just handles the transport layer.

Support

• Docs: https://katalogo.ai/docs
• Issues: https://github.com/anthropics/diana-mcp/issues