Upstash 上下文协议服务器

@upstash/mcp-server
0 Stars 341 次浏览 upstash 更新于 2026-08-23

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

该服务暂未提供标准配置,请参考 README 手动接入

可用工具 (16 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

redis_database_create_new 3 个参数 需填 2 项

Create a new Upstash redis database. NOTE: Ask user for the region and name of the database. NOTE: Don't show the database ID from the response to the user unless explicitly asked or needed.

必填参数:name、primary_region

redis_database_delete 1 个参数 需填 1 项

Delete an Upstash redis database.

必填参数:database_id

redis_database_list_databases

List all Upstash redis databases. Only their names and ids. NOTE: Don't show the database ID from the response to the user unless explicitly asked or needed.

该工具无需必填参数,直接调用即可

redis_database_get_details 1 个参数 需填 1 项

Get further details of a specific Upstash redis database. Includes all details of the database including usage statistics. db_disk_threshold: Total disk usage limit. db_memory_threshold: Maximum memory usage. db_daily_bandwidth_limit: Maximum daily network bandwidth usage. db_request_limit: Total number of commands allowed. All sizes are in bytes NOTE: Don't show the database ID from the response to the user unless explicitly asked or needed.

必填参数:database_id

redis_database_update_regions 2 个参数 需填 2 项

Update the read regions of an Upstash redis database.

必填参数:id、read_regions

redis_database_reset_password 1 个参数 需填 1 项

Reset the password of an Upstash redis database.

必填参数:id

redis_database_get_usage_last_5_days 1 个参数 需填 1 项

Get PRECISE command count and bandwidth usage statistics of an Upstash redis database over the last 5 days. This is a precise stat, not an average. NOTE: Ask user first if they want to see stats for each database seperately or just for one.

必填参数:id

redis_database_get_stats 3 个参数 需填 3 项

Get SAMPLED usage statistics of an Upstash redis database over a period of time (1h, 3h, 12h, 1d, 3d, 7d). Use this to check for peak usages and latency problems. Includes: read_latency_mean, write_latency_mean, keyspace, throughput (cmds/sec), diskusage NOTE: If the user does not specify which stat to get, use throughput as default.

必填参数:id、period、type

redis_database_create_backup 2 个参数 需填 2 项

Create a backup of a specific Upstash redis database. NOTE: Ask user to choose a name for the backup

必填参数:database_id、backup_name

redis_database_delete_backup 2 个参数 需填 2 项

Delete a backup of a specific Upstash redis database.

必填参数:database_id、backup_id

redis_database_restore_backup 2 个参数 需填 2 项

Restore a backup of a specific Upstash redis database. A backup can only be restored to the same database it was created from.

必填参数:database_id、backup_id

redis_database_list_backups 1 个参数 需填 1 项

List all backups of a specific Upstash redis database.

必填参数:database_id

redis_database_set_daily_backup 2 个参数 需填 2 项

Enable or disable daily backups for a specific Upstash redis database.

必填参数:database_id、enable

redis_database_run_single_redis_command 3 个参数 需填 3 项

Run a single Redis command on a specific Upstash redis database. NOTE: For discovery, use SCAN over KEYS. Use TYPE to get the type of a key. NOTE: SCAN cursor [MATCH pattern] [COUNT count] [TYPE type]

必填参数:database_rest_url、database_rest_token、command

redis_database_run_multiple_redis_commands 3 个参数 需填 3 项

Run multiple Redis commands on a specific Upstash redis database

必填参数:database_rest_url、database_rest_token、commands

timestamps_to_date 1 个参数 需填 1 项

Use this tool to convert a timestamp to a human-readable date

必填参数:timestamps

服务介绍

Upstash MCP 服务器

smithery 徽章

模型上下文协议(MCP)是一个用于管理大型语言模型(LLMs)与外部系统之间上下文的新标准化协议。在这个仓库中,我们提供了安装程序以及一个针对Upstash 开发者 API 的 MCP 服务器。

这使得你可以使用 Claude 桌面版或任何 MCP 客户端通过自然语言来完成你的 Upstash 账户中的操作,例如:

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

使用说明

系统要求

如何本地使用

为 Cursor 安装

将此命令添加到 cursor 的 mcp 列表中。更多信息,请查阅 Cursor MCP 文档。

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

通过 npx 安装

  1. 运行 npx @upstash/mcp-server init <UPSTASH_EMAIL> <UPSTASH_API_KEY>。这会为 claude 安装 MCP 服务器。
  2. 重启 Claude 桌面版
  3. 现在你应该能够在 Claude 桌面版中使用 Upstash 命令了

参阅 MCP 文档中的故障排除指南。你也可以通过 Discord 联系我们。

注意:如果你使用的是像 nvm 或 fnm 这样的节点版本管理器,请检查这个问题。你需要更改 MCP 配置中的 node 命令为你 node 二进制文件的绝对路径。

通过 Smithery 安装

要通过 Smithery 自动为 Claude 桌面版安装 Upstash:

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

工具

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

开发

克隆项目并运行:

bun install
npm run watch

这将持续构建项目并监视变化。

为了测试,你可以在项目相同目录下创建一个 .env 文件,内容如下:

UPSTASH_EMAIL=<UPSTASH_EMAIL>
UPSTASH_API_KEY=<UPSTASH_API_KEY>

这将用于设置 Claude 配置和运行 mcp 检查器。

使用 Claude 桌面版进行测试

为了本地开发安装 Claude 桌面版配置,请运行以下命令:

npm run setup

这会在你的 MCP 配置文件中添加一个指向本地包构建的 upstash 条目。

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

注意:与节点版本管理器相关的问题同样适用于这里。如果您使用的是节点版本管理器,请查看使用部分的注释。

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

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

npm run logs

使用 MCP Inspector 进行测试

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

npm run inspector

相关 MCP 服务