@wave-av/mcp-server

Сервер MCP (Model Context Protocol), который предоставляет API потоковой передачи WAVE в качестве инструментов для ИИ-ассистентов по программированию.

Быстрый старт

npx @wave-av/mcp-server

Настройка

1. Получите API-ключ

# Via CLI
wave auth login

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

2. Настройте ваш ИИ-инструмент

Добавьте в ваш .mcp.json (Claude Code, Cursor, Windsurf и т. д.):

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

Доступные инструменты

Потоки (Streams)

Студия (Studio)

Аналитика (Analytics)

Биллинг (Billing)

Ресурсы

Доступ к сущностям WAVE напрямую через схему URI wave://:

• wave://streams/{id} — Конфигурация и статус потока

• wave://productions/{id} — Детали студийного производства

Переменные окружения

Настройка для других ИИ-инструментов

Cursor

Добавьте в .cursor/mcp.json:

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

Windsurf

Добавьте в настройки MCP Windsurf с той же конфигурацией.

Устранение неполадок

Сервер не запускается

Убедитесь, что ваш API-ключ установлен:

echo $WAVE_API_KEY

Инструменты не отображаются

Перезапустите ваш ИИ-инструмент после добавления конфигурации MCP. Большинству инструментов требуется перезапуск для обнаружения новых серверов MCP.

Ошибки подключения

Сервер MCP использует транспорт stdio (без сетевого прослушивателя). Если вы видите ошибки подключения, проверьте, успешно ли выполняется npx:

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

Тестирование сервера

Отправьте запрос JSON-RPC initialize для проверки:

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

Связанные пакеты

• @wave-av/sdk — TypeScript SDK (34 модуля API)

• @wave-av/adk — Набор инструментов для разработчиков агентов (Agent Developer Kit)

• @wave-av/cli — Интерфейс командной строки

• @wave-av/create-app — Создание шаблона нового проекта

• Спецификация OpenAPI — Полная спецификация API

Разработка

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

Лицензия

MIT