WaveSpeed MCP Server
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
An MCP server for the WaveSpeed platform: run any model on the **live catalog** — image, video, audio, 3D — from Claude Code, Claude Desktop, Cursor, Cline, or any MCP client.
Built on the same design as the open-source @wavespeed/cli:
- **No hardcoded models.** The catalog comes from the live API (1h cache); new platform models work the day they ship.
- **One generation verb.** run_model executes anything; get_model_schema tells the agent what inputs a model actually accepts, so it reads before it writes.
- **Inputs are never mutated.** The one explicit transform is the @path marker — a "@./photo.jpg" value inside input uploads the file and substitutes its hosted URL. Bare paths are passed through untouched.
- **Honest pricing.** get_price quotes before you spend and names the inputs the quote was blind to (unpriced_inputs) instead of presenting a formula's floor as "the" price.
Tools
| Tool | What it does |
|---|---|
| list_models | Search the live catalog by text or modality type |
| get_model_schema | A model's real input schema (required, properties, defaults) |
| run_model | Submit + wait; rejects input keys the model doesn't accept; @path inputs upload automatically; returns output URLs |
| get_price | Cost estimate with unpriced_inputs / at_base_price disclosure |
| get_balance | Account credit balance |
| upload_file | Local file → hosted URL (24h content-hash dedupe) |
| get_prediction | Status/outputs of any run by id; optional wait_seconds to wait for it |
Some generations take minutes to hours. run_model waits up to wait_seconds (default 50, max 1800) and then returns done: false with the prediction id — the task keeps running server-side, and get_prediction picks it up. While waiting, both tools send MCP progress notifications that carry the prediction id.
Setup
Auth resolves from WAVESPEED_API_KEY, or from the CLI's stored login (wavespeed login) — one login covers both tools. Keys: wavespeed.ai/accesskey.
**Claude Code**
**Claude Desktop / other clients** (mcpServers config):
Example prompts
- *"Generate a 16:9 hero image of a cyberpunk skyline at golden hour."*