WaveSpeed MCP Server

MCP-сервер для платформы WaveSpeed: запускайте любые модели из живого каталога — изображения, видео, аудио, 3D — из Claude Code, Claude Desktop, Cursor, Cline или любого MCP-клиента.

Построен по той же схеме, что и open-source @wavespeed/cli:

• Никаких захардкоженных моделей. Каталог берётся из живого API (кэш 1 час); новые модели платформы работают в день их выхода.

• Один глагол генерации. run_model выполняет что угодно; get_model_schema сообщает агенту, какие входные данные модель реально принимает, чтобы он сначала читал, а потом писал.

• Входные данные никогда не изменяются. Единственное явное преобразование — маркер @path: значение "@./photo.jpg" внутри input загружает файл и подставляет его размещённый URL. Голые пути передаются без изменений.

• Честные цены. get_price называет цену до того, как вы потратите средства, и указывает входные данные, которые оценка не учла (unpriced_inputs), вместо того чтобы выдавать нижнюю границу формулы за «настоящую» цену.

Инструменты

Если run_model достигает лимита ожидания, задача продолжает выполняться на сервере — в ошибке указан id предсказания, и get_prediction подхватывает его.

Related MCP server: WavespeedMCP

Настройка

Авторизация определяется из WAVESPEED_API_KEY или из сохранённого входа CLI (wavespeed login) — одного входа достаточно для обоих инструментов. Ключи: wavespeed.ai/accesskey.

Claude Code

claude mcp add wavespeed -- npx -y @wavespeed/mcp

Claude Desktop / другие клиенты (конфиг mcpServers):

{
  "mcpServers": {
    "wavespeed": {
      "command": "npx",
      "args": ["-y", "@wavespeed/mcp"],
      "env": { "WAVESPEED_API_KEY": "wsk_..." }
    }
  }
}

Примеры запросов

• «Сгенерируй hero-изображение 16:9 с киберпанк-горизонтом в золотой час.»

• «Возьми ./photo.jpg и замени фон на залитую солнцем кухню.» (агент передаёт "@./photo.jpg")

• «Анимируй ./hero.png с лёгким параллаксом — сначала проверь цену.»

Разработка

npm install
npm run dev        # run from source (stdio)
npm run lint       # typecheck
npm run build      # tsc → dist/

Лицензия

MIT