WaveSpeed MCP Server
MCP-сервер WaveSpeed: агент запускает модели для картинок, видео, аудио и 3D, читает схему входа и узнает цену до запуска
- 37 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запуски тратят кредиты на счете WaveSpeed, лимита на стороне сервера в описании нет
- Инструмент delete_predictions стирает до 100 запусков из истории
Установка
- Работает в
Ручная установка
claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcpУдаленный сервер, доступ подтверждается на странице WaveSpeed.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запуски тратят кредиты на счете WaveSpeed, лимита на стороне сервера в описании нет
- Инструмент delete_predictions стирает до 100 запусков из истории
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает к агенту платформу WaveSpeed. Список моделей он берет из живого каталога API с часовым кэшем, поэтому новые модели работают в день выхода. Общий инструмент run_model запускает любую модель, а get_model_schema перед этим показывает, какие поля она принимает. Недопустимые ключи сервер отклоняет до отправки. Пять коротких инструментов закрывают типовые задачи: generate_image, edit_image, generate_video, edit_video и extend_video. Они используют те же модели, что страница WaveSpeed chat, сами выбирают эндпоинт по входным данным и подгоняют запрос под схему модели. Изменения в запросе сервер перечисляет в поле notes. Флаг estimate_only возвращает цену и готовый запрос без запуска. В значении input строка вида "@./photo.jpg" загружает локальный файл и подставляет вместо него ссылку. Длинные задачи возвращают идентификатор, и агент опрашивает get_prediction до статуса done: ожидание допускается до 1800 секунд, а задача продолжает работать на стороне сервера при обрыве связи. Отдельные инструменты показывают баланс, историю запусков, счета и расход.
Для кого. Дизайнерам и продуктовым командам, которые делают картинки и ролики прямо из Claude Code или Cursor и хотят видеть цену до запуска.
Подходит, если
- Нужна картинка 16:9 для главной страницы, и результат должен лечь в проект ссылкой
- Фон на фотографии из папки проекта заменяют на другой, а файл загружают маркером @путь
- Статичный рисунок оживляют коротким видео, но сначала смотрят расчет стоимости
- Готовый ролик продлевают новым фрагментом через extend_video
- В конце месяца сверяют расход по моделям и список запусков за период
Не подходит, если
- Генерация должна идти локально и бесплатно: сервер ходит в платный сервис WaveSpeed
- Задачи на текст, код или анализ данных: у сервера только модели для картинок, видео, аудио и 3D
- Токен для биллинга выдавать некому: инструменты list_billings и get_usage требуют ключ с доступом к биллингу
- Агент работает в ChatGPT или Claude в вебе и должен читать файлы с вашего компьютера: удаленный вариант их не видит
Пример запроса к агенту
Сгенерируй картинку 16:9 с городом в стиле киберпанк на закате, сначала покажи цену, а потом запусти.MCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
WAVESPEED_API_KEYсекрет- Ключ API WaveSpeed для локального запуска, берется на странице ключей.
Ограничения
Каждый запуск тратит кредиты на счете WaveSpeed, итоговую сумму определяет сам сервис, а оценка get_price остается приблизительной. Для локального режима нужен ключ WAVESPEED_API_KEY из личного кабинета. Удаленный сервер не читает файлы на компьютере: ссылки на публичные адреса или временный адрес загрузки через create_upload. Инструмент delete_predictions удаляет до 100 запусков из истории без возможности вернуть. Доступность WaveSpeed из России при подготовке карточки не проверялась.
Как отключить. В Claude Code удалите сервер командой claude mcp remove wavespeed. При подключении через Claude в вебе или ChatGPT удалите созданный ключ с названием MCP на странице API Keys WaveSpeed: доступ закроется сразу.
Частые вопросы
Как подключить WaveSpeed MCP к Claude Code?
Выполните claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp и подтвердите доступ на странице WaveSpeed. Локальный вариант ставится командой claude mcp add wavespeed -- npx -y @wavespeed/mcp@latest, ключ берется из WAVESPEED_API_KEY.
Сколько стоит запуск модели?
Цену показывает get_price для тех же входных данных, без списания. Списанную сумму определяет сервис, она может отличаться от оценки.
Чем generate_video отличается от run_model?
generate_video выбирает режим (текст, кадр, референсы) по входным данным и использует модели страницы chat, по умолчанию Seedance 2.5. run_model запускает любую модель каталога и требует точных полей из схемы.
Что делать, если генерация идет долго?
Задача возвращает идентификатор, а агент вызывает get_prediction с wait_seconds до 1800. Если связь оборвалась, задача продолжает работать на сервере.
Как отключить доступ, выданный через Claude в вебе?
Откройте страницу API Keys в WaveSpeed и удалите ключ с названием MCP и именем приложения. Подключение прекратится сразу.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер RunAPI: каталог из 160 моделей для изображений, видео, музыки и речи, цены, запуск задач и баланс
Размещенный MCP-сервер Magic Hour: агент генерирует и редактирует видео, изображения и аудио через API сервиса
MCP-сервер редактирует изображения через Photopea: слои, текст, эффекты и экспорт, 46 инструментов для Claude Code и Cursor.
Локальный MCP-сервер для правки и разбора изображений: агент обрезает кадры, находит объекты и читает текст с фото
MCP-сервер для создания и правки картинок: Gemini, OpenAI и Seedream с автоматической доработкой запроса
MCP-сервер для Excalidraw: агент рисует диаграмму, добавляет анимацию по ключевым кадрам, а вы смотрите сборку вживую в браузере
Коротко о README
Документация описывает два способа запуска: удаленный адрес на api.wavespeed.ai и локальный пакет через npx. Они дают одни инструменты, различается работа с файлами. Сервер построен по схеме открытого CLI @wavespeed/cli, и один вход действует для обоих инструментов.