Redis Cloud API MCP Server

1# Redis Cloud API MCP Server
2 
3Model Context Protocol (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems. This repository provides an MCP Server for Redis Cloud's API, allowing you to manage your Redis Cloud resources using natural language.
4 
5This lets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things on your Redis Cloud account, e.g.:
6 
7- "Create a new Redis database in AWS"
8- "What are my current subscriptions?"
9- "Help me choose the right Redis database for my e-commerce application"
10 
11## Features
12 
13### Account Management
14- `get_current_account`: Get details about your current Redis Cloud account
15- `get_current_payment_methods`: List all payment methods configured for your account
16 
17### Subscription Management
18 
19#### Pro Subscriptions
20- `get_pro_subscriptions`: List all Pro subscriptions in your account
21- `create_pro_subscription`: Create a new Pro subscription with advanced configuration options
22  - Supports multi-cloud deployment
23  - Configure memory, persistence, and modules
24  - Set up Active-Active deployments
25  - Custom networking configuration
26 
27#### Essential Subscriptions
28- `get_essential_subscriptions`: List all Essential subscriptions (paginated)
29- `get_essential_subscription_by_id`: Get detailed information about a specific Essential subscription
30- `create_essential_subscription`: Create a new Essential subscription
31- `delete_essential_subscription`: Delete an Essential subscription
32 
33### Database Capabilities
34- `get_database_modules`: List all available database modules (capabilities) supported in your account
35  - Redis modules
36  - Database features
37  - Performance options
38 
39### Cloud Provider Management
40- `get_pro_plans_regions`: Get available regions across cloud providers
41  - AWS regions
42  - GCP regions
43  - Networking options
44  - Availability zones
45 
46### Plans and Pricing
47- `get_essentials_plans`: List available Essential subscription plans (paginated)
48  - Supports AWS, GCP, and Azure
49  - Redis Flex options
50  - Fixed plans
51 
52### Task Management
53- `get_tasks`: List all current tasks in your account
54- `get_task_by_id`: Get detailed information about a specific task
55  - Track deployment status
56  - Monitor subscription changes
57  - View task progress
58 
59 
60## Usage
61 
62#### Prerequisites
63- Valid Redis Cloud API credentials (API Key and Secret Key)
64- Task IDs are returned for long-running operations and can be monitored
65- Paginated responses require multiple calls to retrieve all data
66 
67 
68### Claude Desktop
69 
70To run the MCP server with Claude Desktop, follow these steps:
71 
721. Build the package:
73   ```bash
74   npm run build
75   ```
76 
772. Add the server to Claude Desktop:
78    - Open Claude Desktop settings
79    - Navigate to the Developer tab (make sure you have enabled Developer Mode)
80    - Click on "Edit config"
81    - Open the `claude_desktop_config.json` file in your text editor and add the following configuration:
82   ```json
83   {
84     "mcpServers": {
85       "mcp-redis-cloud": {
86         "command": "node",
87         "args": ["--experimental-fetch", "<absolute_path_to_project_root>/dist/index.js"],
88         "env": {
89           "API_KEY": "<redis_cloud_api_key>",
90           "SECRET_KEY": "<redis_cloud_api_secret_key>"
91         }
92       }
93     }
94   }
95   ```
96 
973. Close Claude Desktop and restart it. The server should now be available in the MCP Servers section.
98 
99### Cursor IDE
100 
101To run the MCP server with Cursor IDE, follow these steps:
102 
1031. Build the package:
104   ```bash
105   npm run build
106   ```
107 
1082. Add the server to Cursor:
109    - Open Cursor Settings
110    - Navigate to the MCP tab
111    - Click on "Add new global MCP Server"
112    - Update the automatically opened `mcp.json` file with the following configuration:
113   ```json
114   {
115     "mcpServers": {
116       "mcp-redis-cloud": {
117         "command": "node",
118         "args": ["--experimental-fetch", "<absolute_path_to_project_root>/dist/index.js"],
119         "env": {
120           "API_KEY": "<redis_cloud_api_key>",
121           "SECRET_KEY": "<redis_cloud_api_secret_key>"
122         }
123       }
124     }
125   }
126   ```
127 
1283. Restart Cursor. The server should now be available in the MCP Servers section.
129 
130 
131## Development
132 
133### Prerequisites
134 
1351. nvm (Node Version Manager)
1362. Node v22.14.0
1373. npm 10.9.2
138 
139### Getting Started
140 
1411. Install dependencies:
142   ```bash
143   nvm use v22.14.0
144   npm install
145   ```
146 
1472. Build the project:
148   ```bash
149   npm run build
150   ```
151 
1523. Test it by using the MCP Inspector:
153    ```bash
154    npx @modelcontextprotocol/inspector node dist/index.js --api-key=<api_key> --secret-key=<secret_key>
155    ```
156 
157### Project Structure
158 
159```
160src/
161├── index.ts              # Entry point
162├── clients/              # API Clients for external services
163│   └── generated         # Generated Redis Cloud API client
164└── tools/                # Tool implementations
165    └── accounts/         # Account tools
166    └── subscriptions/    # Subscription tools
167    └── tasks/            # Task tools
168```
169 
170 
171Note: If you make changes to your code, remember to rebuild and restart Claude Desktop / Cursor:
172```bash
173npm run build
174```
175 
176## Docker Usage
177 
178### Building the Docker Image
179To build the Docker image for the MCP server, run the following command:
180 
181```bash
182docker build -t mcp/redis-cloud .
183```
184 
185### Running the Docker Container
186To run the container, use the following command:
187 
188```bash
189docker run -i --rm \
190  -e API_KEY=<your_redis_cloud_api_key> \
191  -e SECRET_KEY=<your_redis_cloud_api_secret_key> \
192  mcp/redis-cloud
193```
194 
195### Docker Integration with Claude Desktop
196 
197To integrate the Dockerized MCP server with Claude Desktop, follow these steps:
198 
1991. Build the Docker image (if you haven't already):
200   ```bash
201   docker build -t mcp/redis-cloud .
202   ```
203 
2042. Add the server to Claude Desktop:
205   - Open Claude Desktop settings
206   - Navigate to the Developer tab (ensure Developer Mode is enabled)
207   - Click on "Edit config"
208   - Open the `claude_desktop_config.json` file in your text editor
209   - Add the following configuration:
210 
211   ```json
212   {
213     "mcpServers": {
214       "redis-cloud": {
215         "command": "docker",
216         "args": [
217           "run",
218           "-i",
219           "--rm",
220           "-e",
221           "API_KEY=<your_redis_cloud_api_key>",
222           "-e",
223           "SECRET_KEY=<your_redis_cloud_api_secret_key>",
224           "mcp/redis-cloud"
225         ]
226       }
227     }
228   }
229   ```
230 
2313. Replace the placeholder values with your actual API credentials.
232 
2334. Save the configuration file and restart Claude Desktop.
234 
235 
236### Notes
237- Ensure that the required environment variables (`API_KEY`, `SECRET_KEY`) are set correctly.