Upstash MCP 服务器

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

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

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

用法

要求

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

如何在本地使用

为 Claude Desktop 安装

要通过 Smithery 自动为 Claude Desktop 安装 Upstash MCP 服务器，请运行以下命令：

npx -y @smithery/cli@latest install @upstash/mcp-server --client claude

<details> <summary>不使用 Smithery 安装</summary>

npx @upstash/mcp-server init <UPSTASH_EMAIL> <UPSTASH_API_KEY>

这将编辑您的 MCP 配置文件，并为 Upstash 添加一个条目。

</details>

为 Cursor 安装

要通过 Smithery 自动为 Cursor 安装 Upstash MCP 服务器，请运行以下命令：

npx -y @smithery/cli@latest install @upstash/mcp-server --client cursor

<details> <summary>不使用 Smithery 安装</summary>

将以下命令添加到 Cursor 中的 MCP 配置。 有关更多信息，请查看 Cursor MCP 文档。

npx -y @upstash/mcp-server run <UPSTASH_EMAIL> <UPSTASH_API_KEY>

</details>

为 Windsurf 安装

要通过 Smithery 自动为 Windsurf 安装 Upstash MCP 服务器，请运行以下命令：

npx -y @smithery/cli@latest install @upstash/mcp-server --client windsurf

<details> <summary>不使用 Smithery 安装</summary>

将以下命令添加到 Windsurf 中的 MCP 配置。 有关更多信息，请查看 Windsurf MCP 文档。

npx -y @upstash/mcp-server run <UPSTASH_EMAIL> <UPSTASH_API_KEY>

</details>

使用 Docker 运行

您还可以使用提供的 Docker 镜像来运行服务器。

docker build -t upstash-mcp .

# 运行 stdio 服务器，将此命令添加到您的 MCP 配置
docker run --rm -i \
  -e UPSTASH_EMAIL=<UPSTASH_EMAIL> \
  -e UPSTASH_API_KEY=<UPSTASH_API_KEY> \
  upstash-mcp

故障排除

常见问题

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

要解决此问题，您可以通过在 shell 中运行 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 配置和运行 mcp inspector。

使用 Claude Desktop 进行测试

要为本地开发安装 Claude Desktop 配置，请运行以下命令：

pnpm run setup

这会将一个 upstash 条目添加到您的 MCP 配置文件，该条目指向该软件包的本地构建。

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

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

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

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

pnpm run logs

使用 MCP Inspector 进行测试

您还可以使用 MCP Inspector 来测试这些工具。

pnpm run inspector