wavespeed-mcp-worker

Remote MCP server on Cloudflare Workers for WaveSpeed image/video generation. Add it as a custom connector in Claude (works in Claude.ai, Claude Design, Claude Desktop) — no local shell needed.

Tools

Tool	What it does
wavespeed_generate_image	Text → image (default google/nano-banana-2/text-to-image)
wavespeed_edit_image	Edit an image by instruction (default google/nano-banana-2/edit)
wavespeed_generate_video	Text → video / image → video (default bytedance/seedance-2.0/...)
wavespeed_get_result	Poll a long-running job by request_id

Deploy

1. Get keys:

   • Cloudflare API token: dash.cloudflare.com/profile/api-tokens → template Edit Cloudflare Workers
   • Account ID: right sidebar of any Cloudflare dashboard page
   • WaveSpeed key: wavespeed.ai/accesskey

2. Fill .env:

   CLOUDFLARE_API_TOKEN=...
   CLOUDFLARE_ACCOUNT_ID=...
   WAVESPEED_API_KEY=...
   

3. Deploy:

   ./deploy.sh
   

   This runs wrangler deploy and stores the WaveSpeed key as a Worker secret (never in code).

Connect to Claude

Claude → Settings → Connectors → Add custom connector → URL:

https://wavespeed-mcp.<your-subdomain>.workers.dev/mcp

No OAuth needed. The exact URL is printed by deploy.sh (and visible in the Cloudflare dashboard under Workers).

Cost

Cloudflare Workers free tier (100k requests/day) is more than enough. WaveSpeed generations are billed to your WaveSpeed balance.

Local dev

WAVESPEED_API_KEY=... npx wrangler dev