Upstash MCP 服务器

模型上下文协议（MCP）是一种新的标准化协议，用于管理大型语言模型（LLMs）与外部系统之间的上下文。在本仓库中，我们提供了一个安装程序以及一个用于Upstash 开发者 API 的 MCP 服务器。

这使得您可以使用任何 MCP 客户端通过自然语言与您的 Upstash 账户进行交互，例如：

• “在 us-east-1 创建一个新的 Redis 数据库”
• “列出我的数据库”
• “列出 users-db 中以 'user:' 开头的键”
• “创建一个备份”
• “给我过去 7 天内的吞吐量峰值”

使用

快速设置

首先，获取您的 Upstash 凭证：

• 邮箱：您的 Upstash 账户邮箱
• API 密钥：从 Upstash 控制台 → 账户 → API 密钥 获取

将此添加到您的 MCP 客户端配置中：

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

可流式 HTTP 传输（适用于 Web 应用程序）：

使用 http 传输启动您的 MCP 服务器：

npx @upstash/mcp-server@latest --transport http --port 3000 --email YOUR_EMAIL --api-key YOUR_API_KEY

并配置您的 MCP 客户端以使用 HTTP 传输：

{
  "mcpServers": {
    "upstash": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

然后，使用标签（例如 upstash-mcp）构建镜像。确保 Docker Desktop（或 Docker 守护进程）正在运行。 在保存 Dockerfile 的同一目录中运行以下命令：

docker build -t upstash-mcp .

{
  "mcpServers": {
    "upstash": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UPSTASH_EMAIL=YOUR_EMAIL",
        "-e",
        "UPSTASH_API_KEY=YOUR_API_KEY",
        "upstash-mcp"
      ]
    }
  }
}

要求

• Node.js >= v18.0.0
• Upstash API 密钥 - 您可以从这里 创建一个。

故障排除

常见问题

您的 MCP 客户端可能由于 shell 和系统 PATH 之间的差异而无法找到正确的二进制文件。

要解决此问题，您可以通过在 shell 中运行 which npx 或 which docker 来获取二进制文件的完整路径，并在 MCP 配置中将 npx 或 docker 命令替换为完整的二进制路径。

Node 版本管理器

如果您使用的是 node 版本管理器（如 nvm 或 fnm），请查看此问题。您应将 MCP 配置中的 node 命令更改为 node 二进制文件的绝对路径。

其他故障排除

请参阅 MCP 文档中的故障排除指南。您还可以通过 Discord 联系我们。

工具

Redis

• redis_database_create_backup
• redis_database_create_new
• redis_database_delete
• redis_database_delete_backup
• redis_database_get_details
• redis_database_list_backups
• redis_database_list_databases
• redis_database_reset_password
• redis_database_restore_backup
• redis_database_run_multiple_redis_commands
• redis_database_run_single_redis_command
• redis_database_set_daily_backup
• redis_database_update_regions
• redis_database_get_usage_last_5_days
• redis_database_get_stats

开发

克隆项目并运行：

pnpm install
pnpm run watch

这将持续构建项目并监视更改。

为了进行测试，您可以在项目同一目录下创建一个 .env 文件，内容如下：

UPSTASH_EMAIL=<UPSTASH_EMAIL>
UPSTASH_API_KEY=<UPSTASH_API_KEY>

这将用于设置 Claude 配置。

使用 Claude Desktop 进行测试

要为本地开发安装 Claude Desktop 配置，请将以下内容添加到您的 Claude Desktop MCP 配置中：

{
  "mcpServers": {
    "upstash": {
      "command": "node",
      "args": [
        "<path-to-repo>/dist/index.js",
        "run",
        "--email",
        "<UPSTASH_EMAIL>",
        "--api-key",
        "<UPSTASH_API_KEY>"
      ]
    }
  }
}

注意：node 版本管理器的相同问题也适用于此。如果您使用的是 node 版本管理器，请查看使用部分中的说明。

您现在可以使用 Claude Desktop 来运行 Upstash 命令。

要实时查看 MCP 服务器的日志，请运行以下命令：

pnpm run logs