Redis Cloud

Interactúa con la API de Redis Cloud para gestionar tus bases de datos Redis.

GitHub
40
Prueba este MCPPatrocinado

Documentación

Servidor MCP de la API de Redis Cloud

El Protocolo de Contexto de Modelos (MCP) es un protocolo estandarizado para gestionar el contexto entre modelos de lenguaje de gran tamaño (LLMs) y sistemas externos. Este repositorio proporciona un Servidor MCP para la API de Redis Cloud, permitiéndote gestionar tus recursos de Redis Cloud usando lenguaje natural.

Esto te permite usar Claude Desktop, o cualquier Cliente MCP, para usar lenguaje natural y realizar acciones en tu cuenta de Redis Cloud, por ejemplo:

  • "Crea una nueva base de datos Redis en AWS"
  • "¿Cuáles son mis suscripciones actuales?"
  • "Ayúdame a elegir la base de datos Redis adecuada para mi aplicación de comercio electrónico"

Características

Gestión de Cuenta

  • get_current_account: Obtén detalles sobre tu cuenta actual de Redis Cloud
  • get_current_payment_methods: Lista todos los métodos de pago configurados para tu cuenta

Gestión de Suscripciones

Suscripciones Pro

  • get_pro_subscriptions: Lista todas las suscripciones Pro en tu cuenta
  • create_pro_subscription: Crea una nueva suscripción Pro con opciones de configuración avanzadas
    • Soporta despliegue multi-nube
    • Configura memoria, persistencia y módulos
    • Configura despliegues Activo-Activo
    • Configuración de red personalizada

Suscripciones Esenciales

  • get_essential_subscriptions: Lista todas las suscripciones Esenciales (paginadas)
  • get_essential_subscription_by_id: Obtén información detallada sobre una suscripción Esencial específica
  • create_essential_subscription: Crea una nueva suscripción Esencial
  • delete_essential_subscription: Elimina una suscripción Esencial

Capacidades de Base de Datos

  • get_database_modules: Lista todos los módulos de base de datos disponibles (capacidades) soportados en tu cuenta
    • Módulos Redis
    • Características de base de datos
    • Opciones de rendimiento

Gestión de Proveedores de Nube

  • get_pro_plans_regions: Obtén regiones disponibles en todos los proveedores de nube
    • Regiones AWS
    • Regiones GCP
    • Opciones de red
    • Zonas de disponibilidad

Planes y Precios

  • get_essentials_plans: Lista los planes de suscripción Esencial disponibles (paginados)
    • Soporta AWS, GCP y Azure
    • Opciones Redis Flex
    • Planes fijos

Gestión de Tareas

  • get_tasks: Lista todas las tareas actuales en tu cuenta
  • get_task_by_id: Obtén información detallada sobre una tarea específica
    • Rastrea el estado del despliegue
    • Monitorea cambios en las suscripciones
    • Visualiza el progreso de las tareas

Uso

Requisitos previos

  • Credenciales válidas de la API de Redis Cloud (Clave de API y Clave Secreta)
  • Los IDs de tarea se devuelven para operaciones de larga duración y pueden ser monitoreados
  • Las respuestas paginadas requieren múltiples llamadas para recuperar todos los datos

Claude Desktop

Para ejecutar el servidor MCP con Claude Desktop, sigue estos pasos:

  1. Compila el paquete:

    npm run build

  2. Agrega el servidor a Claude Desktop:

    • Abre la configuración de Claude Desktop
    • Navega a la pestaña Desarrollador (asegúrate de haber habilitado el Modo Desarrollador)
    • Haz clic en "Editar configuración"
    • Abre el archivo claude_desktop_config.json en tu editor de texto y agrega la siguiente configuración:
    {
  "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>"
      }
    }
  }
}

  3. Cierra Claude Desktop y reinícialo. El servidor ahora debería estar disponible en la sección de Servidores MCP.

IDE Cursor

Para ejecutar el servidor MCP con el IDE Cursor, sigue estos pasos:

  1. Compila el paquete:

    npm run build

  2. Agrega el servidor a Cursor:

    • Abre la Configuración de Cursor
    • Navega a la pestaña MCP
    • Haz clic en "Agregar nuevo Servidor MCP global"
    • Actualiza el archivo mcp.json que se abre automáticamente con la siguiente configuración:
    {
  "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>"
      }
    }
  }
}

  3. Reinicia Cursor. El servidor ahora debería estar disponible en la sección de Servidores MCP.

Desarrollo

Requisitos previos

  1. nvm (Administrador de Versiones de Node)
  2. Node v22.14.0
  3. npm 10.9.2

Comenzando

  1. Instala las dependencias:

    nvm use v22.14.0
npm install

  2. Compila el proyecto:

    npm run build

  3. Pruébalo usando el Inspector MCP:

    npx @modelcontextprotocol/inspector node dist/index.js --api-key=<api_key> --secret-key=<secret_key>

Estructura del Proyecto

src/
├── index.ts              # Entry point
├── clients/              # API Clients for external services
│   └── generated         # Generated Redis Cloud API client
└── tools/                # Tool implementations
    └── accounts/         # Account tools
    └── subscriptions/    # Subscription tools
    └── tasks/            # Task tools

Nota: Si realizas cambios en tu código, recuerda recompilar y reiniciar Claude Desktop / Cursor:

npm run build

Uso con Docker

Construyendo la Imagen Docker

Para construir la imagen Docker para el servidor MCP, ejecuta el siguiente comando:

docker build -t mcp/redis-cloud .

Ejecutando el Contenedor Docker

Para ejecutar el contenedor, usa el siguiente comando:

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

Integración Docker con Claude Desktop

Para integrar el servidor MCP dockerizado con Claude Desktop, sigue estos pasos:

  1. Construye la imagen Docker (si aún no lo has hecho):

    docker build -t mcp/redis-cloud .

  2. Agrega el servidor a Claude Desktop:

    • Abre la configuración de Claude Desktop
    • Navega a la pestaña Desarrollador (asegúrate de que el Modo Desarrollador esté habilitado)
    • Haz clic en "Editar configuración"
    • Abre el archivo claude_desktop_config.json en tu editor de texto
    • Agrega la siguiente configuración:
    {
  "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"
      ]
    }
  }
}

  3. Reemplaza los valores de los marcadores de posición con tus credenciales API reales.

  4. Guarda el archivo de configuración y reinicia Claude Desktop.

Notas

  • Asegúrate de que las variables de entorno requeridas (API_KEY, SECRET_KEY) estén configuradas correctamente.