WaveSpeed MCP Server

Un servidor MCP para la plataforma WaveSpeed: ejecuta cualquier modelo del catálogo en vivo — imagen, vídeo, audio, 3D — desde Claude Code, Claude Desktop, Cursor, Cline o cualquier cliente MCP.

Construido con el mismo diseño que el @wavespeed/cli de código abierto:

• Sin modelos codificados. El catálogo proviene de la API en vivo (caché de 1 hora); los nuevos modelos de la plataforma funcionan el mismo día que se publican.

• Un verbo de generación. run_model ejecuta cualquier cosa; get_model_schema le dice al agente qué entradas acepta realmente un modelo, para que lea antes de escribir.

• Las entradas nunca se modifican. La única transformación explícita es el marcador @path — un valor "@./photo.jpg" dentro de input sube el archivo y sustituye su URL alojada. Las rutas simples se pasan sin cambios.

• Precios honestos. get_price cotiza antes de que gastes y nombra las entradas que la cotización no pudo ver (unpriced_inputs) en lugar de presentar el mínimo de una fórmula como "el" precio.

Tools

Si run_model alcanza su límite de espera, la tarea sigue ejecutándose en el servidor — el error nombra el id de predicción, y get_prediction lo retoma.

Related MCP server: WavespeedMCP

Setup

La autenticación se resuelve desde WAVESPEED_API_KEY, o desde el inicio de sesión almacenado del CLI (wavespeed login) — un solo inicio de sesión cubre ambas herramientas. Claves: wavespeed.ai/accesskey.

Claude Code

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

Claude Desktop / otros clientes (configuración mcpServers):

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

Example prompts

• "Genera una imagen hero 16:9 de un horizonte cyberpunk a la hora dorada."

• "Toma ./photo.jpg y reemplaza el fondo con una cocina iluminada por el sol." (el agente pasa "@./photo.jpg")

• "Anima ./hero.png con paralaje sutil — comprueba el precio primero."

Desarrollo

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

Licencia

MIT