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)

• Freepik Premium+ subscription (for Seedream 4)

Local Development

# Install dependencies
npm install

# Run in dev mode
npm run dev

# Build
npm run build

Deploy to Smithery

1. Push to GitHub

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

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 → 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

License

MIT