# Freepik Seedream MCP Server

MCP server for Freepik API with **Seedream 4.0** support, optimized for Smithery deployment.

## Features

### Seedream 4.0 (ByteDance)
- **`seedream_generate`** - Generate images from text (up to 4K)
- **`seedream_edit`** - Edit images with natural language
- **`seedream_status`** - Check generation status

### Freepik Stock
- **`search_resources`** - Search photos, vectors, PSDs
- **`get_resource`** - Get resource details
- **`download_resource`** - Get download URLs

### Mystic AI (Legacy)
- **`mystic_generate`** - Generate with Freepik Mystic

## Requirements

- Node.js 18+
- Freepik API Key ([Get one here](https://www.freepik.com/api))
- Freepik Premium+ subscription (for Seedream 4)

## Local Development

```bash
# Install dependencies
npm install

# Run in dev mode
npm run dev

# Build
npm run build
```

## Deploy to Smithery

### 1. Push to GitHub

```bash
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/YOUR_USER/freepik-seedream-mcp.git
git push -u origin main
```

### 2. Deploy on Smithery

1. Go to [smithery.ai](https://smithery.ai)
2. Connect your GitHub account
3. Select your repository
4. Click **Deploy**

You'll get a URL like:
```
https://server.smithery.ai/YOUR_USER/freepik-seedream-mcp/mcp
```

### 3. Connect to Claude Online

1. Go to [claude.ai](https://claude.ai) → Settings → Connectors
2. Click "Add custom connector"
3. Enter:
   - **Name**: Freepik Seedream
   - **URL**: Your Smithery URL
4. When prompted, enter your Freepik API Key

## Usage Examples

### Generate an image
```
"Generate a cyberpunk city at night with neon lights"
```

### Edit an image
```
"Add a sunset sky to this image: https://example.com/photo.jpg"
```

### Search stock photos
```
"Search for business meeting photos"
```

## API Pricing

| Feature | Cost |
|---------|------|
| Seedream 4 | Included with Premium+ |
| Stock Downloads | Included with subscription |
| API Calls | Free tier available |

## License

MIT