MCP-Redis云服务

Name: MCP-Redis云服务
Author: redis

作者：redis33 星标更新：2025-05-05

安装使用来源：spider==github.com

项目介绍

Redis Cloud API MCP Server

模型上下文协议（MCP）是一种标准化协议，用于在大型语言模型（LLMs）与外部系统之间管理上下文。此仓库提供了一个针对Redis Cloud API的MCP服务器，允许您使用自然语言来管理您的Redis Cloud资源。

这使您可以使用Claude Desktop或任何MCP客户端，通过自然语言来完成Redis Cloud账户上的任务，例如：

“在AWS中创建一个新的Redis数据库”
“我的当前订阅是什么？”
“帮我选择适合我电子商务应用的Redis数据库”

功能

账户管理

get_current_account: 获取有关您当前Redis Cloud账户的详细信息
get_current_payment_methods: 列出您账户中配置的所有支付方式

订阅管理

Pro订阅

get_pro_subscriptions: 列出您账户中的所有Pro订阅
create_pro_subscription: 创建一个具有高级配置选项的新Pro订阅
- 支持多云部署
- 配置内存、持久性和模块
- 设置Active-Active部署
- 自定义网络配置

基础订阅

get_essential_subscriptions: 列出所有基础订阅（分页）
get_essential_subscription_by_id: 获取特定基础订阅的详细信息
create_essential_subscription: 创建一个新的基础订阅
delete_essential_subscription: 删除一个基础订阅

数据库能力

get_database_modules: 列出您账户支持的所有可用数据库模块（能力）
- Redis模块
- 数据库特性
- 性能选项

云提供商管理

get_pro_plans_regions: 获取跨云提供商的可用区域
- AWS区域
- GCP区域
- 网络选项
- 可用区

计划和定价

get_essentials_plans: 列出可用的基础订阅计划（分页）
- 支持AWS、GCP和Azure
- Redis Flex选项
- 固定计划

任务管理

get_tasks: 列出您账户中的所有当前任务
get_task_by_id: 获取特定任务的详细信息
- 跟踪部署状态
- 监控订阅更改
- 查看任务进度

使用方法

先决条件

有效的Redis Cloud API凭证（API密钥和秘密密钥）
对于长时间运行的操作，会返回任务ID，并可以进行监控
分页响应需要多次调用来获取所有数据

Claude Desktop

要使用Claude Desktop运行MCP服务器，请按照以下步骤操作：

构建包：
```
npm run build
```

将服务器添加到Claude Desktop：

打开Claude Desktop设置
导航到开发者标签页（确保已启用开发者模式）
单击“编辑配置”
在文本编辑器中打开claude_desktop_config.json文件并添加以下配置：

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

关闭Claude Desktop并重新启动它。现在，服务器应该可以在MCP服务器部分中找到。

Cursor IDE

要使用Cursor IDE运行MCP服务器，请按照以下步骤操作：

构建包：
```
npm run build
```

将服务器添加到Cursor：

打开Cursor设置
导航到MCP标签页
单击“添加新的全局MCP服务器”
更新自动打开的mcp.json文件，添加以下配置：

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

重启Cursor。现在，服务器应该可以在MCP服务器部分中找到。

开发

先决条件

nvm（Node版本管理器）
Node v22.14.0
npm 10.9.2

开始

安装依赖项：
```
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>

项目结构

src/
├── index.ts              # 入口点
├── clients/              # 外部服务的API客户端
│   └── generated         # 生成的Redis Cloud API客户端
└── tools/                # 工具实现
    └── accounts/         # 账户工具
    └── subscriptions/    # 订阅工具
    └── tasks/            # 任务工具

注意：如果您对代码进行了更改，请记得重新构建并重启Claude Desktop/Cursor：

npm run build

Docker使用

构建Docker镜像

要构建MCP服务器的Docker镜像，请运行以下命令：

docker build -t mcp/redis-cloud .

运行Docker容器

要运行容器，请使用以下命令：

docker run -i --rm \
  -e API_KEY=<your_redis_cloud_api_key> \
  -e SECRET_KEY=<your_redis_cloud_api_secret_key> \
  mcp/redis-cloud

Docker与Claude Desktop集成

要将Docker化的MCP服务器与Claude Desktop集成，请按照以下步骤操作：

构建Docker镜像（如果尚未构建）：
```
docker build -t mcp/redis-cloud .
```

将服务器添加到Claude Desktop：

打开Claude Desktop设置
导航到开发者标签页（确保已启用开发者模式）
单击“编辑配置”
在文本编辑器中打开claude_desktop_config.json文件
添加以下配置：

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

将占位符值替换为您实际的API凭证。
保存配置文件并重启Claude Desktop。

注意事项

确保正确设置了所需的环境变量（API_KEY，SECRET_KEY）。