Redis MCP Server

Un servidor MCP para interactuar con bases de datos Redis, permitiendo que los LLMs accedan a almacenes de clave-valor.

Documentación

Redis MCP Server (@gongrzhe/server-redis-mcp@1.0.0)

smithery badge

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) de Redis para interactuar con bases de datos Redis. Este servidor permite que los LLM interactúen con almacenes de clave-valor de Redis a través de un conjunto de herramientas estandarizadas.

Actualización

62 herramientas de Redis MCP en https://github.com/GongRzhe/REDIS-MCP-Server/tree/redis-plus

Instalación y Uso

Instalación mediante Smithery

Para instalar Redis MCP Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @gongrzhe/server-redis-mcp --client claude

Instalación Manual

# Using npx with specific version (recommended)
npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port

# Example:
npx @gongrzhe/server-redis-mcp@1.0.0 redis://localhost:6379

O instalar globalmente:

# Install specific version globally
npm install -g @gongrzhe/server-redis-mcp@1.0.0

# Run after global installation
@gongrzhe/server-redis-mcp redis://your-redis-host:port

Componentes

Herramientas

  • set

    • Establece un par clave-valor de Redis con expiración opcional
    • Entrada:
      • key (string): clave de Redis
      • value (string): Valor a almacenar
      • expireSeconds (number, opcional): Tiempo de expiración en segundos
  • get

    • Obtiene el valor por clave de Redis
    • Entrada: key (string): clave de Redis a recuperar
  • delete

    • Elimina una o más claves de Redis
    • Entrada: key (string | string[]): Clave o arreglo de claves a eliminar
  • list

    • Lista las claves de Redis que coinciden con un patrón
    • Entrada: pattern (string, opcional): Patrón para coincidir claves (predeterminado: *)

Configuración

Uso con Claude Desktop

Para usar este servidor con la aplicación Claude Desktop, agrega la siguiente configuración a la sección "mcpServers" de tu claude_desktop_config.json:

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-redis-mcp@1.0.0",
        "redis://localhost:6379"
      ]
    }
  }
}

Alternativamente, puedes usar el comando node directamente si tienes el paquete instalado:

{
  "mcpServers": {
    "redis": {
      "command": "node",
      "args": [
        "path/to/build/index.js",
        "redis://10.1.210.223:6379"
      ]
    }
  }
}

Uso con Docker

Al usar Docker:

  • Para macOS, usa host.docker.internal si el servidor Redis se está ejecutando en la red del host
  • La URL de Redis se puede especificar como argumento, con valor predeterminado "redis://localhost:6379"
{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/redis", 
        "redis://host.docker.internal:6379"
      ]
    }
  }
}

Desarrollo

Compilación desde el Código Fuente

  1. Clona el repositorio
  2. Instala las dependencias:
    npm install
    
  3. Compila el proyecto:
    npm run build
    

Compilación con Docker

docker build -t mcp/redis .

Licencia

Este servidor MCP está licenciado bajo la Licencia ISC. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.