Upstash MCP 服务器

<img alt="在 VS Code 中安装 (npx)" src="https://img.shields.io/badge/Install%20in%20VS%20Code-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white">

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

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

• "在 us-east-1 创建一个新的 Redis 数据库"
• "列出我的数据库"
• "列出以 'user:' 开头的键在 users-db 中"
• "创建一个备份"
• "给我过去 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 应用程序）：

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

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

<details> <summary><strong>Docker 设置</strong></summary>

1. 创建一个 Dockerfile：

   <summary>点击查看 Dockerfile 内容</summary>

   FROM node:18-alpine
   
   WORKDIR /app
   
   # 全局安装最新版本
   RUN npm install -g @upstash/mcp-server
   
   # 如果需要暴露默认端口（可选，取决于 MCP 客户端交互）
   # EXPOSE 3000
   
   # 默认命令来运行服务器
   CMD ["upstash-mcp-server"]
   

   </details>

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

   docker build -t upstash-mcp .
   

2. 配置您的 MCP 客户端：

   更新您的 MCP 客户端配置以使用 Docker 命令。

   示例配置文件 claude_desktop_config.json：

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

   注意：这是一个示例配置。请参考此 README 中更早的部分中的特定示例（如 Cursor、VS Code 等），以适应结构（例如，mcpServers 对比 servers）。同时，请确保 args 中的镜像名称与 docker build 命令期间使用的标签相匹配。

</details>

需求

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

故障排除

常见问题

您的 mcp 客户端可能因为 shell 和系统 PATH 之间的差异而难以找到正确的二进制文件。

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

Node 版本管理器

如果您使用的是 nvm 或 fnm 等 node 版本管理器，请检查 此问题。您应该将 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