Upstash MCP Server

MCP-сервер Upstash позволяет вашему агенту управлять ресурсами Upstash и отлаживать их напрямую, включая Redis, QStash, Workflow и Upstash Box.

[!TIP] Для большинства рабочих процессов предпочтительнее установить Upstash Skill и позволить вашему агенту использовать @upstash/cli вместо запуска MCP-сервера.

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

Вам понадобятся адрес электронной почты вашего аккаунта Upstash и API-ключ — создайте его в консоли Upstash → Account → API Keys.

MCP-сервер Upstash работает с любым MCP-совместимым клиентом. Если вашего клиента нет в списке ниже, ознакомьтесь с его документацией о том, как добавить stdio MCP-сервер, а затем укажите базовую команду:

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

[!NOTE] Поддерживаются API-ключи только для чтения. Когда сервер запускается с таким ключом, он автоматически отключает все инструменты, которые могут изменить состояние (создание баз данных, удаление резервных копий, повторный запуск рабочих процессов и т. д.). Ваш агент по-прежнему может читать и запрашивать данные вашего аккаунта, но не может вносить изменения.

Выполните эту команду в своем терминале. Дополнительную информацию см. в документации Claude Code MCP.

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

Перейдите в Settings → Cursor Settings → MCP → Add new global MCP server.

Рекомендуемый подход — вставить следующую конфигурацию в файл ~/.cursor/mcp.json в Cursor. Вы также можете выполнить установку для конкретного проекта, создав файл .cursor/mcp.json в папке вашего проекта. Дополнительную информацию см. в документации Cursor MCP.

Начиная с Cursor 1.0, вы можете нажать кнопку установки ниже для мгновенной установки в один клик. Перед подтверждением замените YOUR_EMAIL и YOUR_API_KEY на ваши реальные значения.

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

Добавьте это в файл конфигурации Windsurf MCP по адресу ~/.codeium/windsurf/mcp_config.json. Дополнительную информацию см. в документации Windsurf MCP.

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

Добавьте это в файл конфигурации OpenCode (~/.config/opencode/opencode.json или opencode.json на уровне проекта). Дополнительную информацию см. в документации OpenCode MCP.

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

Дополнительную информацию см. в документации OpenAI Codex MCP.

Использование CLI

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

Ручная настройка

Добавьте это в файл конфигурации Codex (~/.codex/config.toml или .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

[!NOTE] Если вы видите ошибки тайм-аута при запуске, увеличьте startup_timeout_sec до 40.

Нажмите для установки — VS Code запросит ваш адрес электронной почты и API-ключ (они будут сохранены в защищенном хранилище):

Или добавьте это в .vscode/mcp.json (или в вашу пользовательскую настройку mcp.servers). Использование inputs с promptString означает, что ваш API-ключ будет запрашиваться один раз и храниться в защищенном хранилище VS Code, а не в файле конфигурации. Дополнительную информацию см. в документации VS Code MCP.

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

Добавьте это в конфигурацию Antigravity MCP. Дополнительную информацию см. в документации Antigravity MCP.

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

Откройте настройки разработчика Claude Desktop и отредактируйте claude_desktop_config.json. Дополнительную информацию см. в документации Claude Desktop MCP.

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

Откройте файл настроек Gemini CLI по адресу ~/.gemini/settings.json и добавьте Upstash в mcpServers. Подробности см. в конфигурации Gemini CLI.

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

Related MCP server: MCP Server Boilerplate

Примеры промптов

Redis

• "Создай новую базу данных Redis в us-east-1"

• "Выведи список моих баз данных, отсортированный по использованию памяти"

• "Обнови схему пользователя, получив данные из Redis"

• "Создай резервную копию этой БД, а затем очисти ее"

• "Покажи мне скачки пропускной способности за последние 7 дней"

QStash & Workflow

• "Проверь логи QStash и выясни, почему мой вебхук постоянно выдает ошибку"

• "Найди неудачные запуски рабочих процессов для пользователя @admin за сегодня"

• "Повтори запуск неудачного рабочего процесса, который начался 2 часа назад"

• "Обобщи содержимое DLQ прямо сейчас, сгруппировав по типу ошибки"

• "Приостанови расписания, которые выдают ошибки"

Upstash Box

• "Запусти Box, клонируй этот репозиторий и выполни тесты"

• "Сделай снимок этого Box и создай из него 5 копий, назначив каждой задачу GitHub"

• "Мой Box постоянно не запускается, проверь логи и скажи мне, в чем проблема"

API-ключ Upstash Box (необязательно)

Чтобы MCP мог взаимодействовать с Upstash Box, агенту нужен ваш API-ключ Box. По умолчанию вам приходится вставлять его в чат (или хранить в .env) каждый раз, когда агент запускает инструмент Box. Чтобы избежать этого, вы можете встроить ключ в саму настройку MCP, чтобы сервер автоматически подхватывал его при запуске.

Вы можете передать его двумя способами.

Флаг CLI

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

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

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

Отладка

Если сервер ведет себя некорректно или инструмент постоянно выдает ошибку, включите подробное логирование с помощью флага --debug:

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

Каждое внутреннее событие записывается в stderr, который ваш MCP-клиент отображает в своем средстве просмотра логов. Поделитесь соответствующим фрагментом при сообщении о проблеме на GitHub.

Телеметрия

Сервер отправляет анонимную диагностическую информацию в Upstash с каждым запросом: версию SDK MCP-сервера, версию вашей среды выполнения (Node, Bun и т. д.) и базовую информацию о платформе (ОС и архитектура). Данные аккаунта, аргументы инструментов или результаты не собираются. Чтобы отказаться от этого, добавьте --disable-telemetry к аргументам.

Разработка

Клонируйте проект и выполните:

bun i
bun run watch

Это непрерывно собирает проект и отслеживает изменения.

Для тестирования создайте файл .env в корне проекта:

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

Чтобы установить локальный MCP-сервер в Claude Code:

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

Чтобы отслеживать логи MCP-сервера в режиме реального времени:

bun run logs