Upstash 上下文协议服务器
模型上下文协议(MCP)是一种新的、标准化的协议,用于管理大型语言模型(LLMs)和外部系统之间的上下文。在此存储库中,我们提供了安装程序以及适用于Upstash Developer API的MCP服务器。
可用工具 (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 服务器
模型上下文协议(MCP)是一个用于管理大型语言模型(LLMs)与外部系统之间上下文的新标准化协议。在这个仓库中,我们提供了安装程序以及一个针对Upstash 开发者 API 的 MCP 服务器。
这使得你可以使用 Claude 桌面版或任何 MCP 客户端通过自然语言来完成你的 Upstash 账户中的操作,例如:
- "在 us-east-1 创建一个新的 Redis 数据库"
- "列出所有数据库"
- "查看 users-db 中以 'user:' 开头的键"
- "创建备份"
- "给我过去 7 天内的吞吐量峰值"
使用说明
系统要求
- Node.js >= v18.0.0
- Claude 桌面版
- Upstash API 密钥 - 你可以从这里创建一个。
如何本地使用
为 Cursor 安装
将此命令添加到 cursor 的 mcp 列表中。更多信息,请查阅 Cursor MCP 文档。
npx -y @upstash/mcp-server run <UPSTASH_EMAIL> <UPSTASH_API_KEY>
通过 npx 安装
- 运行
npx @upstash/mcp-server init <UPSTASH_EMAIL> <UPSTASH_API_KEY>。这会为 claude 安装 MCP 服务器。 - 重启 Claude 桌面版
- 现在你应该能够在 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_backupredis_database_create_newredis_database_deleteredis_database_delete_backupredis_database_get_detailsredis_database_list_backupsredis_database_list_databasesredis_database_reset_passwordredis_database_restore_backupredis_database_run_multiple_redis_commandsredis_database_run_single_redis_commandredis_database_set_daily_backupredis_database_update_regionsredis_database_get_usage_last_5_daysredis_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