返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端