# wavespeed-mcp-worker

Remote MCP server on Cloudflare Workers for [WaveSpeed](https://wavespeed.ai) 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](https://dash.cloudflare.com/profile/api-tokens) → template **Edit Cloudflare Workers**
   - Account ID: right sidebar of any Cloudflare dashboard page
   - WaveSpeed key: [wavespeed.ai/accesskey](https://wavespeed.ai/accesskey)

2. Fill `.env`:

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

3. Deploy:

   ```bash
   ./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

```bash
WAVESPEED_API_KEY=... npx wrangler dev
```