WavespeedMCP MCP Server

# WavespeedMCP ## [English](README.md) | [中文文档](README.zh.md) WavespeedMCP is a Model Control Protocol (MCP) server implementation for WaveSpeed AI

Local serverstdioPython

What is the WavespeedMCP MCP server?

WavespeedMCP ## English中文文档 WavespeedMCP is a Model Control Protocol (MCP) server implementation for WaveSpeed AI services. It provides a standardized interface for accessing WaveSpeed's image and video. That is what the wavespeedmcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

  • Advanced Image Generation — Create high-quality images from text prompts with support for image-to-image generation, inpainting, and LoRA models
  • Dynamic Video Generation — Transform static images into videos with customizable motion parameters
  • Optimized Performance — Enhanced API polling with intelligent retry logic and detailed progress tracking
  • Flexible Resource Handling — Support for URL, Base64, and local file output modes
  • Comprehensive Error Handling — Specialized exception hierarchy for precise error identification and recovery
  • Robust Logging — Detailed logging system for monitoring and debugging

Getting it running

wavespeed-mcp on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

The tools it exposes

The server publishes 5 tools. What each one is for:

  • Prerequisites — The Prerequisites tool exposed by this server
  • Setup — The Setup tool exposed by this server
  • Timeouts — WavespeedMCP supports two types of timeouts. Configure them via environment variables:
  • Requirements — The Requirements tool exposed by this server
  • Testing — The Testing tool exposed by this server

What it needs from you

Configuration is passed through the environment: WAVESPEED_API_KEY, WAVESPEED_LOG_FILE, WAVESPEED_REQUEST_TIMEOUT, WAVESPEED_WAIT_RESULT_TIMEOUT, WAVESPEED_API_HOST, WAVESPEED_MCP_BASE_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  • Python 3.11+ - WaveSpeed API key (obtain from WaveSpeed AI)

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

This sits in the AI and media services group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. WavespeedMCP's toolset — Prerequisites, Setup, Timeouts and 2 more — is a fair guide to whether it matches your workflow. It is maintained by WaveSpeedAI; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
SetupThe Setup tool exposed by this server.
TimeoutsWavespeedMCP supports two types of timeouts. Configure them via environment variables:
RequirementsThe Requirements tool exposed by this server.
TestingThe Testing tool exposed by this server.

How to install the WavespeedMCP MCP server

{
  "mcpServers": {
    "server-wavespeedai": {
      "command": "uvx",
      "args": ["wavespeed-mcp"],
      "env": {
        "WAVESPEED_API_KEY": "your-value",
        "WAVESPEED_LOG_FILE": "your-value",
        "WAVESPEED_REQUEST_TIMEOUT": "your-value",
        "WAVESPEED_WAIT_RESULT_TIMEOUT": "your-value",
        "WAVESPEED_API_HOST": "your-value",
        "WAVESPEED_MCP_BASE_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.11+ - WaveSpeed API key (obtain from WaveSpeed AI)
VariableDescriptionRequired
WAVESPEED_API_KEYCredential the server authenticates with.Yes
WAVESPEED_LOG_FILEConfiguration value read at startup.Optional
WAVESPEED_REQUEST_TIMEOUTConfiguration value read at startup.Optional
WAVESPEED_WAIT_RESULT_TIMEOUTConfiguration value read at startup.Optional
WAVESPEED_API_HOSTEndpoint or connection string the server talks to.Optional
WAVESPEED_MCP_BASE_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use WavespeedMCP to Prerequisites.
  • Use WavespeedMCP to Setup.
  • Use WavespeedMCP to Timeouts.

Frequently asked questions

WavespeedMCP wraps the WaveSpeed API into the MCP standard, adding intelligent polling, progress tracking, retry logic, and multiple output modes (URL, Base64, local). It also integrates seamlessly with MCP-compatible clients like Claude Desktop.