MCP 服务器

Redis Cloud API MCP Server

Redis Cloud API MCP 服务器为 Redis Cloud 的 API 提供了一个 MCP 服务器，允许您使用自然语言管理您的 Redis Cloud 资源。

README

Redis Cloud API MCP 服务器

模型上下文协议 (MCP) 是一种用于管理大型语言模型 (LLM) 和外部系统之间上下文的标准协议。此存储库提供了一个用于 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 部署
- 自定义网络配置

Essential 订阅

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 密钥和 Secret 密钥）
任务 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 Version Manager)
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：