@wave-av/mcp-server

MCP-Server (Model Context Protocol), der WAVE-Streaming-APIs als Tools für KI-Programmierassistenten bereitstellt.

Schnelleinstieg

npx @wave-av/mcp-server

Einrichtung

1. API-Schlüssel abrufen

# Via CLI
wave auth login

# Or create at https://wave.online/settings/api-keys

2. KI-Tool konfigurieren

Fügen Sie dies zu Ihrer .mcp.json hinzu (Claude Code, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "wave": {
      "command": "npx",
      "args": ["-y", "@wave-av/mcp-server"],
      "env": {
        "WAVE_API_KEY": "wave_live_..."
      }
    }
  }
}

Verfügbare Tools

Streams

Studio

Analysen

Abrechnung

Ressourcen

Greifen Sie direkt über das wave:// URI-Schema auf WAVE-Entitäten zu:

• wave://streams/{id} - Stream-Konfiguration und Status

• wave://productions/{id} - Details zur Studio-Produktion

Umgebungsvariablen

Einrichtung für andere KI-Tools

Cursor

Fügen Sie dies zu .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "wave": {
      "command": "npx",
      "args": ["-y", "@wave-av/mcp-server"],
      "env": { "WAVE_API_KEY": "wave_live_..." }
    }
  }
}

Windsurf

Fügen Sie dies mit derselben Konfiguration zu den Windsurf-MCP-Einstellungen hinzu.

Fehlerbehebung

Server startet nicht

Überprüfen Sie, ob Ihr API-Schlüssel gesetzt ist:

echo $WAVE_API_KEY

Tools erscheinen nicht

Starten Sie Ihr KI-Tool neu, nachdem Sie die MCP-Konfiguration hinzugefügt haben. Die meisten Tools erfordern einen Neustart, um neue MCP-Server zu erkennen.

Verbindungsfehler

Der MCP-Server verwendet den stdio-Transport (kein Netzwerk-Listener). Wenn Verbindungsfehler auftreten, prüfen Sie, ob npx erfolgreich ausgeführt werden kann:

npx @wave-av/mcp-server --version

Server testen

Senden Sie eine JSON-RPC-Initialisierungsanfrage zur Überprüfung:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | npx @wave-av/mcp-server

Zugehörige Pakete

• @wave-av/sdk — TypeScript SDK (34 API-Module)

• @wave-av/adk — Agent Developer Kit

• @wave-av/cli — Befehlszeilenschnittstelle

• @wave-av/create-app — Neues Projekt erstellen

• OpenAPI-Spezifikation — Vollständige API-Spezifikation

Entwicklung

cd packages/mcp-server
pnpm install
pnpm run build
pnpm run dev       # Watch mode
pnpm run type-check

Lizenz

MIT