🚀 Upstash MCP 服务器使用指南

本指南将介绍 Upstash 的 MCP 服务器的安装、运行配置、问题排查、进阶使用、开发说明、工具列表以及联系方式等内容。

🚀 快速开始

安装说明

• 使用 npx 或 docker 安装 Upstash 的 MCP 服务器。

  npx @upstash/mcp-server install
  

• 如果使用 Docker，请参考以下命令构建镜像：

  docker build -t upstash-mcp .
  

运行配置

• 在终端中运行以下命令，获取 npx 或 docker 的完整路径，并替换 MCP 配置文件中的相关命令。

  which npx 或者 which docker
  

• 如果使用 Node Version Manager（如 nvm 或 fnm），请参考 此问题，将 MCP 配置文件中的 node 命令替换为 Node 的完整路径。

🔍 通用问题排查

常见问题

如果 MCP 客户端因 PATH 环境变量的差异而无法找到正确的二进制文件，可以通过以下步骤解决：

1. 在终端中运行 which npx 或 which docker，获取其完整路径。
2. 将这些路径替换到 MCP 配置文件中的相应命令中。

Node 管理工具

使用 nvm 或 fnm 的用户，请确保将 MCP 配置文件中的 node 命令替换为 Node.js 的完整路径，以避免版本冲突问题。

📚 详细文档

进阶说明

Docker 运行示例

docker run --rm -i \
  -e UPSTASH_EMAIL=<UPSTASH_EMAIL> \
  -e UPSTASH_API_KEY=<UPSTASH_API_KEY> \
  upstash-mcp

环境变量配置

创建一个 .env 文件，内容如下：

UPSTASH_EMAIL=<你的 Upstash 邮箱>
UPSTASH_API_KEY=<你的 Upstash API 密钥>

开发说明

本地开发

pnpm install
pnpm run watch

这将持续构建项目并实时跟踪代码变化。

Claude Desktop 配置

• 执行以下命令安装本地配置：

pnpm run setup

• 在 MCP 配置文件中添加 upstash 条目，指向本地构建的包：

{
  "upstash": {
    "command": "node",
    "args": ["<项目路径>/dist/index.js", "run", "<UPSTASH_EMAIL>", "<UPSTASH_API_KEY>"]
  }
}

日志查看

执行以下命令实时查看 MCP 服务器的日志：

pnpm run logs

工具列表

Redis 相关工具

• redis_database_create_backup
• redis_database_create_new
• redis_database_delete
• redis_database_delete_backup
• redis_database_restore_from_backup
• 更多工具请参考 官方文档。

联系方式

如需进一步帮助，请访问 Upstash 的 官方网站 或联系他们的 支持团队。