How do I use wavespeed-mcp-worker?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@wavespeed-mcp-worker Generate an image of a serene mountain lake at sunrise." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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`

Related MCP server: WavespeedMCP

Deploy

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

Fill .env:

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

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

mcp-wanOAuth
io.github.AceDataCloud
MCP server for Wan AI video generation
AI & Machine Learning Image & Video Processing
21
ViewMax MCP A
io.github.bytevirts
Remote MCP for AI video, image, music and speech generation.
Audio Processing Image & Video Processing Speech Processing
141
mcp-veoOAuth
io.github.AceDataCloud
MCP server for Google Veo AI video generation
Multimedia Processing Image & Video Processing Entertainment & Media
23
mcp-klingOAuth
io.github.AceDataCloud
MCP server for Kling AI video generation
Image & Video Processing AI & Machine Learning
21

Related MCP Servers

mcp-media-engine
Multimedia Processing AI & Machine Learning
Tr1ckyMag1ca1
A
license
A
quality
B
maintenance
MCP server for AI-powered image, audio, and video generation, enabling media creation directly from Claude, Cursor, and other MCP clients.
Updated 2 months ago (2026-07-14 15:20 UTC)
11
39 npm
MIT
WavespeedMCP
AI & Machine Learning Image & Video Processing
honeyvig
F
license
A
quality
D
maintenance
An MCP server that provides a standardized interface for accessing WaveSpeed AI's image and video generation capabilities, including text-to-image, image-to-image, inpainting, and dynamic video generation.
Updated 10 months ago (2025-11-15 10:17 UTC)
3
-
Nano Banana Remote MCP Server
AI & Machine Learning Image & Video Processing
Ayonz-Dev
F
license
Not graded
quality
B
maintenance
A remote MCP server that exposes Gemini image generation/editing as a custom connector for Claude, enabling image creation and editing from any chat interface.
Updated 2 months ago (2026-07-22 23:22 UTC)
-
gemini-image-mcp-http
Image & Video Processing AI & Machine Learning
soloniki007
F
license
Not graded
quality
C
maintenance
Remote MCP server (Streamable HTTP) for generating and editing images via Google Gemini, usable as a custom connector in Claude.
Updated 2 months ago (2026-07-10 12:19 UTC)
-