by WaveSpeedAI
Provides a Model Control Protocol server enabling access to WaveSpeed AI's image and video generation capabilities through standardized API calls, supporting various resource output modes and extensive configuration options.
Wavespeed MCP offers a server implementation of the Model Control Protocol that bridges client applications with WaveSpeed AI's image‑to‑text, image‑to‑image, inpainting, and dynamic video generation services. It standardizes request/response handling, progress tracking, and error management, allowing developers to integrate high‑quality visual AI capabilities without dealing directly with the underlying REST endpoints.
pip install wavespeed-mcp
WAVESPEED_API_KEY
, WAVESPEED_API_HOST
, WAVESPEED_API_RESOURCE_MODE
)--api-key
, --api-host
, --config
)wavespeed_mcp_config_demo.json
)wavespeed-mcp --api-key <YOUR_API_KEY>
python -m wavespeed_mcp --api-key <YOUR_API_KEY> --config-path /path/to/claude/config
Afterwards, start the server and launch the client application.Q: Which Python version is required? A: Python 3.11 or newer.
Q: Do I need a WaveSpeed account? A: Yes, an API key from WaveSpeed AI is mandatory.
Q: Can I change the default API endpoints?
A: Absolutely. Override them via environment variables such as WAVESPEED_API_TEXT_TO_IMAGE_ENDPOINT
.
Q: How are resources returned?
A: Choose between url
, base64
, or local
modes using WAVESPEED_API_RESOURCE_MODE
.
Q: Is there test coverage?
A: A pytest suite is provided; run pytest
or pytest --cov=wavespeed_mcp
to verify functionality.
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.
Install directly from PyPI:
pip install wavespeed-mcp
To use WavespeedMCP with your IDE or application, add the following configuration:
{
"mcpServers": {
"Wavespeed": {
"command": "wavespeed-mcp",
"env": {
"WAVESPEED_API_KEY": "wavespeedkey"
}
}
}
}
Start the WavespeedMCP server:
wavespeed-mcp --api-key your_api_key_here
WavespeedMCP can be integrated with Claude Desktop. To generate the necessary configuration file:
python -m wavespeed_mcp --api-key your_api_key_here --config-path /path/to/claude/config
This command generates a claude_desktop_config.json
file that configures Claude Desktop to use WavespeedMCP tools. After generating the configuration:
wavespeed-mcp
commandWavespeedMCP can be configured through:
Environment Variables:
WAVESPEED_API_KEY
: Your WaveSpeed API key (required)WAVESPEED_API_HOST
: API host URL (default: https://api.wavespeed.ai)WAVESPEED_MCP_BASE_PATH
: Base path for output files (default: ~/Desktop)WAVESPEED_API_RESOURCE_MODE
: Resource output mode (options: url, base64, local; default: url)WAVESPEED_LOG_LEVEL
: Logging level (options: DEBUG, INFO, WARNING, ERROR; default: INFO)WAVESPEED_API_TEXT_TO_IMAGE_ENDPOINT
: Custom endpoint for text-to-image generation (default: /wavespeed-ai/flux-dev)WAVESPEED_API_IMAGE_TO_IMAGE_ENDPOINT
: Custom endpoint for image-to-image generation (default: /wavespeed-ai/flux-kontext-pro)WAVESPEED_API_VIDEO_ENDPOINT
: Custom endpoint for video generation (default: /wavespeed-ai/wan-2.1/i2v-480p-lora)Command-line Arguments:
--api-key
: Your WaveSpeed API key--api-host
: API host URL--config
: Path to configuration fileConfiguration File (JSON format):
See wavespeed_mcp_config_demo.json
for an example.
WavespeedMCP follows a clean, modular architecture:
server.py
: Core MCP server implementation with tool definitionsclient.py
: Optimized API client with intelligent pollingutils.py
: Comprehensive utility functions for resource handlingexceptions.py
: Specialized exception hierarchy for error handlingconst.py
: Constants and default configuration valuespip install -e ".[dev]"
Run the test suite:
pytest
Or with coverage reporting:
pytest --cov=wavespeed_mcp
This project is licensed under the MIT License - see the LICENSE file for details.
For support or feature requests, please contact the WaveSpeed AI team at support@wavespeed.ai.
Please log in to share your review and rating for this MCP.
Discover more MCP servers with similar functionality and use cases
by danny-avila
Provides a customizable ChatGPT‑like web UI that integrates dozens of AI models, agents, code execution, image generation, web search, speech capabilities, and secure multi‑user authentication, all open‑source and ready for self‑hosting.
by ahujasid
BlenderMCP integrates Blender with Claude AI via the Model Context Protocol (MCP), enabling AI-driven 3D scene creation, modeling, and manipulation. This project allows users to control Blender directly through natural language prompts, streamlining the 3D design workflow.
by pydantic
Enables building production‑grade generative AI applications using Pydantic validation, offering a FastAPI‑like developer experience.
by GLips
Figma-Context-MCP is a Model Context Protocol (MCP) server that provides Figma layout information to AI coding agents. It bridges design and development by enabling AI tools to directly access and interpret Figma design data for more accurate and efficient code generation.
by mcp-use
Easily create and interact with MCP servers using custom agents, supporting any LLM with tool calling and offering multi‑server, sandboxed, and streaming capabilities.
by sonnylazuardi
This project implements a Model Context Protocol (MCP) integration between Cursor AI and Figma, allowing Cursor to communicate with Figma for reading designs and modifying them programmatically.
by lharries
WhatsApp MCP Server is a Model Context Protocol (MCP) server for WhatsApp that allows users to search, read, and send WhatsApp messages (including media) through AI models like Claude. It connects directly to your personal WhatsApp account via the WhatsApp web multi-device API and stores messages locally in a SQLite database.
by idosal
GitMCP is a free, open-source remote Model Context Protocol (MCP) server that transforms any GitHub project into a documentation hub, enabling AI tools to access up-to-date documentation and code directly from the source to eliminate "code hallucinations."
by Klavis-AI
Klavis AI provides open-source Multi-platform Control Protocol (MCP) integrations and a hosted API for AI applications. It simplifies connecting AI to various third-party services by managing secure MCP servers and authentication.