akp-110/mcp-outfit-rater

Outfit Rater MCP Server

An MCP server that helps Claude rate your outfits by providing real-time context about the weather, your calendar events, and your personal style preferences.

Features

• Outfit Analysis: Retrieves your latest outfit photo for Claude to analyze.
• Weather Context: Fetches current weather and forecast from OpenWeatherMap to ensure your outfit is practical.
• Calendar Integration: Checks your calendar (Google, Outlook, or iCal) to ensure your outfit is appropriate for your day's events (e.g., formal for interviews, casual for coffee).
• Style Preferences: Remembers your style preferences and past ratings to give personalized advice.
• Rating System: Saves ratings and feedback to track your style evolution.

Installation

1. Clone the repository:

   git clone <repository-url>
   cd outfit-rater-mcp
   

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

Configuration

Create a .env file in the root directory with the following variables:

# Weather (Required for real data)
OPENWEATHER_API_KEY=your_api_key_here

# Calendar Provider (Options: mock, google, outlook, ical)
CALENDAR_PROVIDER=mock

# Google Calendar (Required if provider is google)
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REFRESH_TOKEN=your_refresh_token

# Outlook Calendar (Required if provider is outlook)
OUTLOOK_ACCESS_TOKEN=your_access_token

# iCal (Required if provider is ical)
ICAL_URL=your_ical_url

Claude Desktop Configuration

Add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "outfit-rater": {
      "command": "node",
      "args": ["/path/to/outfit-rater-mcp/dist/server.js"],
      "env": {
        "OPENWEATHER_API_KEY": "your_key",
        "CALENDAR_PROVIDER": "mock"
      }
    }
  }
}

Usage

Once configured and added to Claude Desktop, you can ask Claude questions like:

• "Rate my outfit for today."
• "Is this outfit okay for my meeting later?"
• "What should I wear given the weather?"

Available Tools

• get_outfit_photo: Retrieves the latest uploaded outfit photo.
• get_weather_context: Gets current weather and forecast.
• get_calendar_events: Fetches today's calendar events.
• get_user_style_preferences: Retrieves your style profile.
• save_outfit_rating: Saves the rating and feedback for an outfit.

Development

• npm run dev: Build and run the server.
• npm run build: Build the TypeScript code.