# Magic Hour MCP Server

MCP server for [Magic Hour AI](https://magichour.ai) — face swap videos, face swap photos, lip sync, face detection, and file management.

## Tools

| Tool | Description |
|------|-------------|
| `face_swap_video` | Swap a face onto a video (file/URL source) |
| `face_swap_video_youtube` | Swap a face onto a YouTube video |
| `face_swap_video_individual` | Swap specific faces using face detection IDs |
| `face_swap_photo` | Swap a face onto a photo |
| `detect_faces` | Detect faces in an image or video |
| `get_face_detection_result` | Get detected face IDs and URLs |
| `lip_sync` | Sync lip movements to an audio track |
| `upload_file` | Upload a file to Magic Hour storage |
| `get_video_project_status` | Check video project status and get download URLs |
| `get_image_project_status` | Check image project status and get download URLs |
| `delete_video_project` | Delete a video project |
| `delete_image_project` | Delete an image project |

## Setup

1. Get an API key from [magichour.ai/settings/developer](https://magichour.ai/settings/developer)

2. Install dependencies:
```bash
npm install
```

3. Build:
```bash
npm run build
```

## Claude Desktop Configuration

Add to `~/.claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "magic-hour": {
      "command": "node",
      "args": ["/path/to/magic-hour-mcp/dist/index.js"],
      "env": {
        "MAGIC_HOUR_API_KEY": "mhk_live_your_key_here"
      }
    }
  }
}
```

## Claude Code Configuration

Add to `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "magic-hour": {
      "command": "node",
      "args": ["/path/to/magic-hour-mcp/dist/index.js"],
      "env": {
        "MAGIC_HOUR_API_KEY": "mhk_live_your_key_here"
      }
    }
  }
}
```

## Usage Example

```
Face swap a dance video:
1. Upload your face image: upload_file → get file_path
2. Start face swap: face_swap_video with video URL + face file_path
3. Poll status: get_video_project_status until "complete"
4. Download from the returned URL

Individual face swap:
1. Detect faces: detect_faces on the source video
2. Get results: get_face_detection_result to see all faces
3. Swap specific faces: face_swap_video_individual with face mappings
```

## License

MIT