suprsonic-mcp Server

@suprsonic/mcp

MCP-сервер для Suprsonic. Предоставляет любому ИИ-агенту десятки возможностей через одно подключение.

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

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Получите API-ключ на suprsonic.ai/app/apis.

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "suprsonic": {
      "command": "npx",
      "args": ["-y", "@suprsonic/mcp"],
      "env": {
        "SUPRSONIC_API_KEY": "omk_your_key"
      }
    }
  }
}

Cursor / VS Code

Добавьте в .cursor/mcp.json или конфигурацию MCP VS Code:

{
  "suprsonic": {
    "command": "npx",
    "args": ["-y", "@suprsonic/mcp"],
    "env": {
      "SUPRSONIC_API_KEY": "omk_your_key"
    }
  }
}

Удалённый HTTP (для Claude API, ChatGPT, программных агентов)

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp --http --port 3100

Затем подключитесь к http://localhost:3100/mcp.

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

Инструмент	Что делает
search	Поиск в интернете (ИИ-синтез, SERP или и то, и другое)
scrape	Извлечение содержимого любого URL в Markdown
profiles	Поиск профессиональных профилей по имени или URL LinkedIn
emails	Поиск профессиональных адресов электронной почты
images	Генерация изображений по текстовым запросам
tts	Преобразование текста в речь
stt	Преобразование аудио в текст
sms	Отправка SMS или сообщений WhatsApp
documents	Извлечение структурированных данных из URL
companies	Поиск данных о компании по домену
email-verify	Проверка доставляемости email
transcribe	Транскрибация аудио с метками говорящих
invoice-parse	Извлечение данных из счетов
subtitle	Генерация субтитров SRT/VTT
file-convert	Конвертация файлов между 200+ форматами
bg-remove	Удаление фона изображений
screenshot	Создание скриншотов веб-страниц

Формат ответа

Каждый инструмент возвращает унифицированный объект ответа:

{
  "success": true,
  "data": {
    "results": [
      { "title": "OpenAI raises $6.6B", "url": "https://...", "snippet": "..." }
    ]
  },
  "error": null,
  "metadata": {
    "provider_used": "serperdev",
    "providers_tried": ["serperdev"],
    "response_time_ms": 1200,
    "request_id": "req_abc123"
  },
  "credits_used": 1
}

При ошибке success имеет значение false, а error содержит подробности (см. ниже).

Обработка ошибок

Структура объекта ошибки (возвращается, когда success имеет значение false):

{
  "type": "billing_error",
  "title": "Insufficient credits",
  "status": 402,
  "detail": "Your account has 0 credits remaining. Add credits at suprsonic.ai/app/billing.",
  "is_retriable": false,
  "retry_after_seconds": null,
  "error_category": "billing"
}

Категории ошибок: transient (безопасно для повтора), permanent (неверный запрос), authentication (недействительный ключ), billing (недостаточно кредитов).

При использовании MCP ИИ-агент получает ошибку в ответе инструмента и может решить, стоит ли повторить попытку, основываясь на is_retriable и retry_after_seconds.

Полная справка API со всеми параметрами и примерами ответов: suprsonic.ai/apis