Upstash MCP Server

Official
MIT License
175
26
  • Linux
  • Apple

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows interaction with Redis databases, including creating new databases, running Redis commands, listing databases, managing backups, and viewing usage statistics.

  • Integrates with Upstash Developer API to manage Upstash resources through natural language commands, such as creating databases, listing resources, running commands, and viewing metrics.

Upstash MCP 服务器

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

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

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

用法

要求

如何在本地使用

安装 Claude Desktop

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

npx -y @smithery/cli@latest install @upstash/mcp-server --client claude
npx @upstash/mcp-server init <UPSTASH_EMAIL> <UPSTASH_API_KEY>

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

为 Cursor 安装

要通过Smithery自动安装 Upstash MCP Server for Cursor,请运行以下命令:

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

在 Cursor 的 MCP 配置中添加以下命令。更多信息,请查看Cursor MCP 文档

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

风帆冲浪安装

要通过Smithery自动安装 Windsurf 的 Upstash MCP 服务器,请运行以下命令:

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

在 Windsurf 的 MCP 配置中添加以下命令。更多信息,请参阅Windsurf MCP 文档

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

使用 Docker 运行

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

docker build -t upstash-mcp . # Run the stdio server, add this command to you MCP config docker run --rm -i \ -e UPSTASH_EMAIL=<UPSTASH_EMAIL> \ -e UPSTASH_API_KEY=<UPSTASH_API_KEY> \ upstash-mcp

故障排除

常见问题

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

要解决此问题,您可以通过在 shell 中运行which npxwhich docker来获取二进制文件的完整路径,并用完整的二进制路径替换 MCP 配置中的npxdocker命令。

节点版本管理器

如果您正在使用 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 检查器。

使用 Claude Desktop 进行测试

要安装用于本地开发的 Claude Desktop 配置,请运行以下命令:

pnpm run setup

这将向您的 MCP 配置文件中添加一个upstash条目,指向包的本地构建。

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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

  1. Usage
    1. Requirements
    2. How to use locally
    3. Tools
    4. Development
ID: 4slca1893i