mcp-redis-cloud

用途

mcp-redis-cloud 是 Redis 官方仓库提供的 MCP（Model Context Protocol）服务器，用于将 Redis Cloud API 接入支持 MCP 的客户端（如 Claude Desktop、Cursor 等）。通过该服务器，用户可以用自然语言管理 Redis Cloud 账户中的资源，例如：

“在 AWS 上创建一个新的 Redis 数据库”
“我当前的订阅有哪些？”
“帮我为电商应用选择合适的 Redis 数据库”

主要能力

该 MCP 服务器封装了 Redis Cloud API 的多类操作，按功能分组如下：

账户管理

get_current_account：获取当前 Redis Cloud 账户详情
get_current_payment_methods：列出账户配置的所有支付方式

订阅管理

get_pro_subscriptions：列出账户中所有 Pro 订阅
create_pro_subscription：创建新的 Pro 订阅，支持高级配置选项，包括多云部署、内存/持久化/模块配置、Active-Active 部署、自定义网络配置
get_essential_subscriptions：列出所有 Essential 订阅（分页）
get_essential_subscription_by_id：获取指定 Essential 订阅的详细信息
create_essential_subscription：创建新的 Essential 订阅
delete_essential_subscription：删除 Essential 订阅

数据库能力

get_database_modules：列出账户支持的数据库模块（能力），包括 Redis 模块、数据库功能、性能选项

云厂商管理

get_pro_plans_regions：获取各云厂商可用区域，包括 AWS 区域、GCP 区域、网络选项、可用区

套餐与定价

get_essentials_plans：列出可用的 Essential 订阅套餐（分页），支持 AWS、GCP、Azure，包含 Redis Flex 选项和固定套餐

任务管理

get_tasks：列出账户中当前所有任务
get_task_by_id：获取指定任务的详细信息，可跟踪部署状态、监控订阅变更、查看任务进度

使用方式

前置条件

需要有效的 Redis Cloud API 凭据（API Key 和 Secret Key）。

在 Claude Desktop 中使用

构建包：npm run build
打开 Claude Desktop 设置，进入 Developer 标签（需启用开发者模式），点击 “Edit config”，在 claude_desktop_config.json 中添加配置：

{
  "mcpServers": {
    "mcp-redis-cloud": {
      "command": "node",
      "args": ["--experimental-fetch", "<absolute_path_to_project_root>/dist/index.js"],
      "env": {
        "API_KEY": "<redis_cloud_api_key>",
        "SECRET_KEY": "<redis_cloud_api_secret_key>"
      }
    }
  }
}

关闭并重启 Claude Desktop，服务器将出现在 MCP Servers 区域。

在 Cursor IDE 中使用

打开 Cursor 设置，进入 MCP 标签，点击 “Add new global MCP Server”，在自动打开的 mcp.json 中填入与上述相同的配置。
重启 Cursor，服务器将出现在 MCP Servers 区域。

本地开发

使用 nvm 切换到 v22.14.0：nvm use v22.14.0
安装依赖：npm install
构建项目：npm run build
使用 MCP Inspector 测试：npx @modelcontextprotocol/inspector node dist/index.js --api-key=<api_key> --secret-key=<secret_key>
修改代码后需重新构建并重启 Claude Desktop / Cursor。

Docker 部署

构建镜像：docker build -t mcp/redis-cloud .
运行容器：docker run -i --rm -e API_KEY=<your_redis_cloud_api_key> -e SECRET_KEY=<your_redis_cloud_api_secret_key> mcp/redis-cloud
与 Claude Desktop 集成时，在 claude_desktop_config.json 中使用 docker 命令配置：

{
  "mcpServers": {
    "redis-cloud": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "API_KEY=<your_redis_cloud_api_key>", "-e", "SECRET_KEY=<your_redis_cloud_api_secret_key>", "mcp/redis-cloud"]
    }
  }
}

保存配置并重启 Claude Desktop，确保环境变量 API_KEY、SECRET_KEY 设置正确。

适用场景

通过自然语言快速创建和管理 Redis Cloud 数据库与订阅
在 Claude Desktop 或 Cursor 中直接查询账户、订阅、套餐、区域和任务状态
需要多云部署、Active-Active 或自定义网络配置的 Redis Cloud 资源管理
使用 Docker 方式集成 MCP 服务器到现有工作流

限制

需要有效的 Redis Cloud API 凭据（API Key 和 Secret Key）
长时操作会返回任务 ID，需通过任务管理接口监控
分页响应需要多次调用才能获取全部数据
修改代码后必须重新构建并重启客户端
资料未提供具体的收费、价格或平台兼容性细节