WaveSpeed

WaveSpeed

WaveSpeed MCP server providing AI agents with image and video generation capabilities.

20
Stars
4
Forks
0
Releases

Overview

WavespeedMCP is a Model Control Protocol (MCP) server implementation for WaveSpeed AI services. It exposes WaveSpeed's image and video generation capabilities through a standardized MCP interface, enabling programmatic control of generation pipelines from clients and tools. The server offers advanced image generation, including text-to-image with support for image-to-image, inpainting, and LoRA models, along with dynamic video generation that can transform static images into videos with configurable motion. It emphasizes robust, production-ready operation with optimized API polling, intelligent retry logic, and detailed progress tracking. Resource handling is flexible, supporting outputs as URLs, Base64-encoded data, or local files. Errors are managed through a dedicated exception hierarchy, enabling precise identification and recovery. Logging is robust and configurable, with console or rotating file outputs, and adjustable log levels. Configuration is highly flexible, supporting environment variables, command-line arguments, and JSON configuration files, plus per-request timeouts and a separate total wait timeout for polling results. The project follows a modular architecture with server, client, utilities, and exception modules and provides installation, configuration, and usage guidance, including Claude Desktop integration.

Details

Owner
WaveSpeedAI
Language
Python
License
Updated
2025-12-07

Features

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.

Multiple Configuration Options

Support for environment variables, command-line arguments, and configuration files.

Audience

DevelopersIntegrate WaveSpeed image/video generation via MCP in apps and services.
MCP IntegratorsUse WavespeedMCP to expose generation capabilities through standardized MCP calls.
Claude DesktopClaude Desktop integrations to configure and run WavespeedMCP tools for asset generation.

Tags

MCPMCP serverWaveSpeedWaveSpeed AIimage generationvideo generationimage-to-imageinpaintingLoRAresource handlingloggingconfigurationClaude DesktopPythonAPI keyCLI