@suprsonic/mcp

MCP-Server für Suprsonic. Verleiht jedem KI-Agenten Dutzende von Fähigkeiten über eine einzige Verbindung.

Schnelleinstieg

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Holen Sie sich Ihren API-Schlüssel unter suprsonic.ai/app/apis.

Claude Desktop

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

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

Cursor / VS Code

Fügen Sie dies zu .cursor/mcp.json oder der VS Code MCP-Konfiguration hinzu:

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

Remote HTTP (für Claude API, ChatGPT, programmatische Agenten)

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

Verbinden Sie sich dann mit http://localhost:3100/mcp.

Verfügbare Tools

Antwortformat

Jedes Tool gibt ein einheitliches Antwortobjekt zurück:

{
  "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
}

Bei einem Fehler ist success auf false gesetzt und error enthält die Details (siehe unten).

Fehlerbehandlung

Struktur des Fehlerobjekts (wird zurückgegeben, wenn success false ist):

{
  "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"
}

Fehlerkategorien: transient (sicher für Wiederholungsversuche), permanent (ungültige Anfrage), authentication (ungültiger Schlüssel), billing (kein Guthaben mehr).

Bei der Verwendung von MCP erhält der KI-Agent den Fehler in der Tool-Antwort und kann basierend auf is_retriable und retry_after_seconds entscheiden, ob ein erneuter Versuch sinnvoll ist.

Vollständige API-Referenz mit allen Parametern und Beispielantworten: suprsonic.ai/apis