WaveSpeed MCP Server

Ein MCP-Server für die WaveSpeed-Plattform: Führe jedes Modell aus dem Live-Katalog aus — Bild, Video, Audio, 3D — von Claude Code, Claude Desktop, Cursor, Cline oder jedem MCP-Client.

Basierend auf demselben Design wie das Open-Source-@wavespeed/cli:

• Keine fest codierten Modelle. Der Katalog stammt aus der Live-API (1h-Cache); neue Plattformmodelle funktionieren am Tag ihrer Veröffentlichung.

• Ein Generierungsverb. run_model führt alles aus; get_model_schema sagt dem Agenten, welche Eingaben ein Modell tatsächlich akzeptiert, sodass es liest, bevor es schreibt.

• Eingaben werden nie verändert. Die einzige explizite Transformation ist die @path-Markierung — ein "@./photo.jpg"-Wert innerhalb von input lädt die Datei hoch und ersetzt sie durch ihre gehostete URL. Bloße Pfade werden unverändert durchgereicht.

• Ehrliche Preisgestaltung. get_price bietet einen Preis, bevor du ausgibst, und nennt die Eingaben, die das Angebot nicht berücksichtigt hat (unpriced_inputs), statt den Mindestwert einer Formel als „den“ Preis darzustellen.

Tools

Wenn run_model sein Wartelimit erreicht, läuft die Aufgabe serverseitig weiter — der Fehler nennt die Prediction-ID, und get_prediction holt sie ab.

Related MCP server: WavespeedMCP

Einrichtung

Die Authentifizierung erfolgt über WAVESPEED_API_KEY oder den gespeicherten Login der CLI (wavespeed login) — ein Login deckt beide Tools ab. Schlüssel: wavespeed.ai/accesskey.

Claude Code

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

Claude Desktop / andere Clients (mcpServers-Konfiguration):

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

Beispiel-Prompts

• „Erzeuge ein 16:9-Hero-Bild einer Cyberpunk-Skyline zur goldenen Stunde.“

• „Nimm ./photo.jpg und ersetze den Hintergrund durch eine sonnendurchflutete Küche.“ (der Agent übergibt "@./photo.jpg")

• „Animiere ./hero.png mit subtiler Parallaxe — prüfe zuerst den Preis.“

Entwicklung

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

Lizenz

MIT