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

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

What it needs from you

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

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.