wavespeed-mcp

# WavespeedMCP ## [English](README.md) ｜ [中文文档](README.zh.md) 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 generation capabilities through the MCP protocol. ## 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 ## Installation ### Prerequisites - Python 3.11+ - WaveSpeed API key (obtain from [WaveSpeed AI](https://wavespeed.ai)) ### Setup Install directly from PyPI: ```bash pip install wavespeed-mcp ``` ### MCP Configuration To use WavespeedMCP with your IDE or application, add the following configuration: ```json { "mcpServers": { "WaveSpeed": { "command": "wavespeed-mcp", "env": { "WAVESPEED_API_KEY": "your-api-key-here", "WAVESPEED_LOG_FILE": "/tmp/wavespeed-mcp.log" } } } } ``` ## Usage ### Running the Server Start the WavespeedMCP server: ```bash wavespeed-mcp --api-key your_api_key_here ``` ### Claude Desktop Integration WavespeedMCP can be integrated with Claude Desktop. To generate the necessary configuration file: ```bash python -m wavespeed_mcp --api-key your_api_key_here --config-path /path/to/claude/config ``` This command generates a `claude_desktop_conf…