{"id":30872859,"url":"https://github.com/WaveSpeedAI/mcp-server","last_synced_at":"2025-09-07T22:37:00.122Z","repository":{"id":296241297,"uuid":"989439963","full_name":"WaveSpeedAI/mcp-server","owner":"WaveSpeedAI","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-29T16:29:47.000Z","size":163,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-29T17:55:31.439Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WaveSpeedAI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-24T05:18:33.000Z","updated_at":"2025-05-29T16:29:50.000Z","dependencies_parsed_at":"2025-06-03T03:03:56.246Z","dependency_job_id":null,"html_url":"https://github.com/WaveSpeedAI/mcp-server","commit_stats":null,"previous_names":["wavespeedai/mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/WaveSpeedAI/mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WaveSpeedAI%2Fmcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WaveSpeedAI%2Fmcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WaveSpeedAI%2Fmcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WaveSpeedAI%2Fmcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WaveSpeedAI","download_url":"https://codeload.github.com/WaveSpeedAI/mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WaveSpeedAI%2Fmcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274107649,"owners_count":25223451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-07T22:34:54.791Z","updated_at":"2025-09-07T22:37:00.106Z","avatar_url":"https://github.com/WaveSpeedAI.png","language":"Python","funding_links":[],"categories":["Media Processing","Production-Ready Servers","官方 MCP 服务器列表","📦 Other"],"sub_categories":["Image Generation"],"readme":"# WavespeedMCP\n\n## [English](README.md) ｜ [中文文档](README.zh.md)\n\nWavespeedMCP 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.\n\n## Features\n\n- **Advanced Image Generation**: Create high-quality images from text prompts with support for image-to-image generation, inpainting, and LoRA models\n- **Dynamic Video Generation**: Transform static images into videos with customizable motion parameters\n- **Optimized Performance**: Enhanced API polling with intelligent retry logic and detailed progress tracking\n- **Flexible Resource Handling**: Support for URL, Base64, and local file output modes\n- **Comprehensive Error Handling**: Specialized exception hierarchy for precise error identification and recovery\n- **Robust Logging**: Detailed logging system for monitoring and debugging\n- **Multiple Configuration Options**: Support for environment variables, command-line arguments, and configuration files\n\n## Installation\n\n### Prerequisites\n\n- Python 3.11+\n- WaveSpeed API key (obtain from [WaveSpeed AI](https://wavespeed.ai))\n\n### Setup\n\nInstall directly from PyPI:\n\n```bash\npip install wavespeed-mcp\n```\n\n### MCP Configuration\n\nTo use WavespeedMCP with your IDE or application, add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"Wavespeed\": {\n      \"command\": \"wavespeed-mcp\",\n      \"env\": {\n        \"WAVESPEED_API_KEY\": \"wavespeedkey\"\n      }\n    }\n  }\n}\n```\n\n## Usage\n\n### Running the Server\n\nStart the WavespeedMCP server:\n\n```bash\nwavespeed-mcp --api-key your_api_key_here\n```\n\n### Claude Desktop Integration\n\nWavespeedMCP can be integrated with Claude Desktop. To generate the necessary configuration file:\n\n```bash\npython -m wavespeed_mcp --api-key your_api_key_here --config-path /path/to/claude/config\n```\n\nThis command generates a `claude_desktop_config.json` file that configures Claude Desktop to use WavespeedMCP tools. After generating the configuration:\n\n1. Start the WavespeedMCP server using the `wavespeed-mcp` command\n2. Launch Claude Desktop, which will use the configured WavespeedMCP tools\n\n## Configuration Options\n\nWavespeedMCP can be configured through:\n\n1. **Environment Variables**:\n\n   - `WAVESPEED_API_KEY`: Your WaveSpeed API key (required)\n   - `WAVESPEED_API_HOST`: API host URL (default: https://api.wavespeed.ai)\n   - `WAVESPEED_MCP_BASE_PATH`: Base path for output files (default: ~/Desktop)\n   - `WAVESPEED_API_RESOURCE_MODE`: Resource output mode (options: url, base64, local; default: url)\n   - `WAVESPEED_LOG_LEVEL`: Logging level (options: DEBUG, INFO, WARNING, ERROR; default: INFO)\n   - `WAVESPEED_API_TEXT_TO_IMAGE_ENDPOINT`: Custom endpoint for text-to-image generation (default: /wavespeed-ai/flux-dev)\n   - `WAVESPEED_API_IMAGE_TO_IMAGE_ENDPOINT`: Custom endpoint for image-to-image generation (default: /wavespeed-ai/flux-kontext-pro)\n   - `WAVESPEED_API_VIDEO_ENDPOINT`: Custom endpoint for video generation (default: /wavespeed-ai/wan-2.1/i2v-480p-lora)\n\n2. **Command-line Arguments**:\n\n   - `--api-key`: Your WaveSpeed API key\n   - `--api-host`: API host URL\n   - `--config`: Path to configuration file\n\n3. **Configuration File** (JSON format):\n   See `wavespeed_mcp_config_demo.json` for an example.\n\n## Architecture\n\nWavespeedMCP follows a clean, modular architecture:\n\n- `server.py`: Core MCP server implementation with tool definitions\n- `client.py`: Optimized API client with intelligent polling\n- `utils.py`: Comprehensive utility functions for resource handling\n- `exceptions.py`: Specialized exception hierarchy for error handling\n- `const.py`: Constants and default configuration values\n\n## Development\n\n### Requirements\n\n- Python 3.11+\n- Development dependencies: `pip install -e \".[dev]\"`\n\n### Testing\n\nRun the test suite:\n\n```bash\npytest\n```\n\nOr with coverage reporting:\n\n```bash\npytest --cov=wavespeed_mcp\n```\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Support\n\nFor support or feature requests, please contact the WaveSpeed AI team at support@wavespeed.ai.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWaveSpeedAI%2Fmcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWaveSpeedAI%2Fmcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWaveSpeedAI%2Fmcp-server/lists"}