🚀 Upstash MCP 服务器

模型上下文协议（MCP）是一个新的标准化协议，用于在大型语言模型（LLMs）和外部系统之间管理上下文。本仓库提供了安装程序以及针对Upstash 开发者 API的 MCP 服务器。借助它，你能够使用 Claude Desktop 或任何 MCP 客户端，通过自然语言在你的 Upstash 账户上完成各类操作，例如：

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

🚀 快速开始

✨ 主要特性

• 支持通过自然语言在 Upstash 账户上执行多种操作。
• 提供安装程序和针对 Upstash 开发者 API 的 MCP 服务器。

📦 安装指南

先决条件

• Node.js >= v18.0.0
• Claude Desktop
• Upstash API 密钥 - 你可以从这里创建一个。

在本地使用

1. 运行 npx @upstash/mcp-server-upstash init <UPSTASH_EMAIL> <UPSTASH_API_KEY>
2. 重启 Claude Desktop
3. 现在你应该可以在 Claude Desktop 中使用 Upstash 命令了

⚠️ 重要提示

如果你正在使用 nvm 或 fnm 等节点版本管理工具，请参阅此问题(此处)。你应该将 MCP 配置中的 node 命令更改为节点二进制文件的绝对路径。

💻 使用示例

工具 - Redis

以下是一些 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_stats

📚 详细文档

开发

克隆项目并运行：

bun install
npm run watch

这将持续构建项目并监视更改。

为了测试，可以在项目目录的同一目录中创建一个 .env 文件，内容如下：

UPSTASH_EMAIL=<UPSTASH_EMAIL>
UPSTASH_API_KEY=<UPSTASH_API_KEY>

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

使用 Claude Desktop 测试

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

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 检查器测试

你还可以使用 MCP 检查器进行测试。

npm run inspector

🔍 更多帮助

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