Redis MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides access to Redis database operations through a Model Context Protocol (MCP) server. Includes tools for various Redis commands such as HMSET, HGET, HGETALL, SCAN, SET, GET, DEL, ZADD, ZRANGE, ZRANGEBYSCORE, ZREM, SADD, and SMEMBERS.

Servidor MCP de Redis

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona acceso a las operaciones de base de datos de Redis.

Estructura del proyecto

src/ ├── interfaces/ │ └── types.ts # Shared TypeScript interfaces and types ├── tools/ │ ├── base_tool.ts # Abstract base class for Redis tools │ ├── tool_registry.ts # Registry managing all available Redis tools │ ├── hmset_tool.ts # HMSET Redis operation │ ├── hget_tool.ts # HGET Redis operation │ ├── hgetall_tool.ts # HGETALL Redis operation │ ├── scan_tool.ts # SCAN Redis operation │ ├── set_tool.ts # SET Redis operation │ ├── get_tool.ts # GET Redis operation │ ├── del_tool.ts # DEL Redis operation │ ├── zadd_tool.ts # ZADD Redis operation │ ├── zrange_tool.ts # ZRANGE Redis operation │ ├── zrangebyscore_tool.ts # ZRANGEBYSCORE Redis operation │ └── zrem_tool.ts # ZREM Redis operation └── redis_server.ts # Main server implementation

Herramientas disponibles

HerramientaTipoDescripciónEsquema de entrada
conjunto de hmsetComando hashEstablecer varios campos hash con varios valoreskey : cadena (clave hash) fields : objeto (pares campo-valor a establecer)
hgetComando hashObtener el valor de un campo hashkey : cadena (clave hash) field : cadena (campo a obtener)
hgetallComando hashObtener todos los campos y valores en un hashkey : cadena (clave hash)
escanearComando de tecladoEscanear claves de Redis que coincidan con un patrónpattern : cadena (patrón a coincidir, p. ej., "usuario:*") count : número, opcional (número de claves a devolver)
colocarComando de cadenaEstablezca el valor de la cadena con las opciones NX y PX opcionaleskey : cadena (clave para establecer) value : cadena (valor para establecer) nx : booleano, opcional (solo se establece si no existe) px : número, opcional (vencimiento en milisegundos)
conseguirComando de cadenaObtener el valor de la cadenakey : cadena (clave a obtener)
delComando de tecladoEliminar una clavekey : cadena (clave para eliminar)
ZaddComando de conjunto ordenadoAgregar uno o más miembros a un conjunto ordenadokey : cadena (clave del conjunto ordenado) members : matriz de objetos con score : número y value : cadena
rango zComando de conjunto ordenadoDevuelve un rango de miembros de un conjunto ordenado por índicekey : cadena (clave del conjunto ordenado) start : número (índice de inicio) stop : número (índice de fin) withScores : booleano, opcional (incluir puntuaciones en la salida)
Puntuación de zrangebyComando de conjunto ordenadoDevuelve miembros de un conjunto ordenado con puntuaciones entre mínima y máximakey : cadena (clave del conjunto ordenado) min : número (puntuación mínima) max : número (puntuación máxima) withScores : booleano, opcional (incluir puntuaciones en la salida)
zremComando de conjunto ordenadoEliminar uno o más miembros de un conjunto ordenadokey : cadena (clave del conjunto ordenado) members : matriz de cadenas (miembros a eliminar)
tristeComando de configuraciónAgregar uno o más miembros a un conjuntokey : cadena (clave del conjunto) members : matriz de cadenas (miembros que se agregarán al conjunto)
miembrosComando de configuraciónObtener todos los miembros en un conjuntokey : cadena (Establecer clave)

Uso

Configure en su cliente MCP (por ejemplo, Claude Desktop, Cline):

{ "mcpServers": { "redis": { "command": "npx", "args": ["redis-mcp", "--redis-host", "localhost", "--redis-port", "6379"], "disabled": false } } }

Argumentos de la línea de comandos

  • --redis-host : host del servidor Redis (predeterminado: localhost)
  • --redis-port : puerto del servidor Redis (predeterminado: 6379)

Instalación mediante herrería

Para instalar Redis Server para Claude Desktop automáticamente a través de Smithery :

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

Desarrollo

Para agregar una nueva herramienta Redis:

  1. Cree una nueva clase de herramienta en src/tools/ que extienda RedisTool
  2. Define la interfaz de la herramienta en src/interfaces/types.ts
  3. Registre la herramienta en src/tools/tool_registry.ts

Ejemplo de implementación de la herramienta:

export class MyTool extends RedisTool { name = 'mytool'; description = 'Description of what the tool does'; inputSchema = { type: 'object', properties: { // Define input parameters }, required: ['requiredParam'] }; validateArgs(args: unknown): args is MyToolArgs { // Implement argument validation } async execute(args: unknown, client: RedisClientType): Promise<ToolResponse> { // Implement tool logic } }

Licencia

MIT: https://opensource.org/license/mit

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Permite a los usuarios realizar operaciones de base de datos de Redis utilizando las herramientas del Protocolo de contexto de modelo (MCP), lo que permite una gestión de datos eficiente a través de comandos como configurar, obtener y escanear campos hash.

  1. Project Structure
    1. Available Tools
      1. Usage
        1. Command Line Arguments
          1. Installing via Smithery
        2. Development
          1. License
            ID: cbn7lsbp7h