Upstash MCP-Server

Der Upstash MCP-Server ermöglicht es Ihrem Agenten, Ihre Upstash-Ressourcen direkt zu verwalten und zu debuggen, über Redis, QStash, Workflow und Upstash Box hinweg.

Schnellstart

Sie benötigen Ihre Upstash-Konto-E-Mail-Adresse und einen API-Schlüssel – erstellen Sie einen unter Upstash Console → Account → API Keys.

Der Upstash MCP-Server funktioniert mit jedem MCP-kompatiblen Client. Wenn Ihr Client unten nicht aufgeführt ist, lesen Sie in dessen Dokumentation nach, wie ein stdio-MCP-Server hinzugefügt wird, und verweisen Sie dann auf den Basisbefehl:

npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

Führen Sie diesen Befehl in Ihrem Terminal aus. Weitere Informationen finden Sie in der Claude Code MCP-Dokumentation.

claude mcp add --scope user upstash -- npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

Gehen Sie zu Settings → Cursor Settings → MCP → Add new global MCP server.

Das Einfügen der folgenden Konfiguration in Ihre Cursor-Datei ~/.cursor/mcp.json ist der empfohlene Ansatz. Sie können die Installation auch in einem bestimmten Projekt vornehmen, indem Sie eine .cursor/mcp.json in Ihrem Projektordner erstellen. Weitere Informationen finden Sie in der Cursor MCP-Dokumentation.

Seit Cursor 1.0 können Sie für eine sofortige Ein-Klick-Installation auf die Schaltfläche unten klicken. Ersetzen Sie YOUR_EMAIL und YOUR_API_KEY durch Ihre echten Werte, bevor Sie bestätigen.

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

Fügen Sie dies Ihrer Windsurf-MCP-Konfigurationsdatei unter ~/.codeium/windsurf/mcp_config.json hinzu. Weitere Informationen finden Sie in der Windsurf MCP-Dokumentation.

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

Fügen Sie dies Ihrer OpenCode-Konfigurationsdatei hinzu (~/.config/opencode/opencode.json oder eine opencode.json auf Projektebene). Weitere Informationen finden Sie in der OpenCode MCP-Dokumentation.

{
  "mcp": {
    "upstash": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ],
      "enabled": true
    }
  }
}

Weitere Informationen finden Sie in der OpenAI Codex MCP-Dokumentation.

Verwendung der CLI

codex mcp add upstash -- npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

Manuelle Konfiguration

Fügen Sie dies Ihrer Codex-Konfigurationsdatei hinzu (~/.codex/config.toml oder .codex/config.toml):

[mcp_servers.upstash]
command = "npx"
args = ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]
startup_timeout_sec = 20

Klicken Sie zum Installieren – VS Code fragt nach Ihrer E-Mail-Adresse und Ihrem API-Schlüssel (diese werden im geheimen Speicher von VS Code gespeichert):

Oder fügen Sie dies zu .vscode/mcp.json (oder Ihrer Benutzer-Einstellung mcp.servers) hinzu. Die Verwendung von inputs mit promptString bedeutet, dass Ihr API-Schlüssel einmal abgefragt und im geheimen Speicher von VS Code aufbewahrt wird, anstatt in der Konfigurationsdatei zu liegen. Weitere Informationen finden Sie in der VS Code MCP-Dokumentation.

{
  "inputs": [
    { "type": "promptString", "id": "email", "description": "Upstash email" },
    { "type": "promptString", "id": "apiKey", "description": "Upstash API key", "password": true }
  ],
  "servers": {
    "upstash": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "${input:email}",
        "--api-key",
        "${input:apiKey}"
      ]
    }
  }
}

Fügen Sie dies Ihrer Antigravity-MCP-Konfiguration hinzu. Weitere Informationen finden Sie in der Antigravity MCP-Dokumentation.

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

Öffnen Sie die Entwicklereinstellungen von Claude Desktop und bearbeiten Sie claude_desktop_config.json. Weitere Informationen finden Sie in der Claude Desktop MCP-Dokumentation.

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

Öffnen Sie die Einstellungsdatei der Gemini CLI unter ~/.gemini/settings.json und fügen Sie Upstash zu mcpServers hinzu. Details finden Sie unter Gemini CLI Configuration.

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

Related MCP server: Memex

Beispiel-Prompts

Redis

• "Erstelle eine neue Redis-Datenbank in us-east-1"

• "Liste meine Datenbanken sortiert nach Speichernutzung auf"

• "Aktualisiere das Benutzerschema durch Abruf aus Redis"

• "Erstelle ein Backup dieser Datenbank und leere sie dann"

• "Zeige mir Durchsatzspitzen während der letzten 7 Tage"

QStash & Workflow

• "Überprüfe die QStash-Logs und finde heraus, warum mein Webhook ständig fehlschlägt"

• "Finde fehlgeschlagene Workflow-Ausführungen für Benutzer @admin von heute"

• "Wiederhole die fehlgeschlagene Workflow-Ausführung, die vor 2 Stunden gestartet wurde"

• "Fasse zusammen, was sich gerade in der DLQ befindet, gruppiert nach Fehlertyp"

• "Pausiere die Zeitpläne, die Fehler verursachen"

Upstash Box

• "Starte eine Box, klone dieses Repository und führe die Tests aus"

• "Erstelle einen Snapshot dieser Box und erstelle 5 Kopien davon, weise jeder ein GitHub-Issue zu"

• "Meine Box startet ständig nicht, überprüfe die Logs und sag mir, was falsch ist"

Upstash Box API-Schlüssel (optional)

Damit der MCP mit Upstash Box interagieren kann, benötigt der Agent Ihren Box-API-Schlüssel. Standardmäßig müssen Sie ihn jedes Mal, wenn der Agent ein Box-Tool ausführt, in den Chat einfügen (oder in einer .env behalten). Um dies zu vermeiden, können Sie den Schlüssel direkt in die MCP-Einrichtung integrieren, sodass der Server ihn beim Start automatisch übernimmt.

Sie können ihn auf zwei Arten übergeben.

CLI-Flag

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY",
        "--box-api-key",
        "YOUR_BOX_API_KEY"
      ]
    }
  }
}

Umgebungsvariable

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ],
      "env": {
        "UPSTASH_BOX_API_KEY": "YOUR_BOX_API_KEY"
      }
    }
  }
}

Debugging

Wenn sich der Server fehlerhaft verhält oder ein Tool ständig fehlschlägt, aktivieren Sie die ausführliche Protokollierung mit dem --debug-Flag:

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY",
        "--debug"
      ]
    }
  }
}

Jedes interne Ereignis wird dann in stderr geschrieben, das Ihr MCP-Client in seinem eigenen Log-Viewer anzeigt. Teilen Sie den relevanten Ausschnitt, wenn Sie ein Problem auf GitHub melden.

Telemetrie

Der Server sendet bei jeder Anfrage anonyme Diagnoseinformationen an Upstash: die MCP-Server-SDK-Version, Ihre Laufzeitversion (Node, Bun usw.) und grundlegende Plattforminformationen (Betriebssystem und Architektur). Es werden keine Kontodaten, Tool-Argumente oder Ergebnisse gesammelt. Um dies zu deaktivieren, fügen Sie --disable-telemetry zu den Argumenten hinzu.

Entwicklung

Klonen Sie das Projekt und führen Sie Folgendes aus:

bun i
bun run watch

Dies erstellt das Projekt kontinuierlich und überwacht Änderungen.

Erstellen Sie zum Testen eine .env-Datei im Projektstammverzeichnis:

UPSTASH_EMAIL=<UPSTASH_EMAIL>
UPSTASH_API_KEY=<UPSTASH_API_KEY>
# Optional, for Box tools:
UPSTASH_BOX_API_KEY=<UPSTASH_BOX_API_KEY>

So installieren Sie den lokalen MCP-Server in Claude Code:

claude mcp add --transport stdio upstash -- bun --watch dist/index.js --debug

So verfolgen Sie die Logs des MCP-Servers in Echtzeit:

bun run logs