Back to MCP directory
publicPublicdnsLocal runtime

Upstash

Upstash MCP Server是一个基于Model Context Protocol(MCP)的服务器,允许用户通过自然语言与Upstash开发者API交互,管理Redis数据库等资源。

article

README

🚀 Upstash MCP 服务器使用指南

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

🚀 快速开始

安装说明

  • 使用 npxdocker 安装 Upstash 的 MCP 服务器。
    npx @upstash/mcp-server install
    
  • 如果使用 Docker,请参考以下命令构建镜像:
    docker build -t upstash-mcp .
    

运行配置

  • 在终端中运行以下命令,获取 npxdocker 的完整路径,并替换 MCP 配置文件中的相关命令。
    which npx 或者 which docker
    
  • 如果使用 Node Version Manager(如 nvmfnm),请参考 此问题,将 MCP 配置文件中的 node 命令替换为 Node 的完整路径。

🔍 通用问题排查

常见问题

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

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

Node 管理工具

使用 nvmfnm 的用户,请确保将 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 的 官方网站 或联系他们的 支持团队

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client