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

Herramienta	Tipo	Descripción	Esquema de entrada
conjunto de hmset	Comando hash	Establecer varios campos hash con varios valores	`key` : cadena (clave hash) `fields` : objeto (pares campo-valor a establecer)
hget	Comando hash	Obtener el valor de un campo hash	`key` : cadena (clave hash) `field` : cadena (campo a obtener)
hgetall	Comando hash	Obtener todos los campos y valores en un hash	`key` : cadena (clave hash)
escanear	Comando de teclado	Escanear claves de Redis que coincidan con un patrón	`pattern` : cadena (patrón a coincidir, p. ej., "usuario:*") `count` : número, opcional (número de claves a devolver)
colocar	Comando de cadena	Establezca el valor de la cadena con las opciones NX y PX opcionales	`key` : 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)
conseguir	Comando de cadena	Obtener el valor de la cadena	`key` : cadena (clave a obtener)
del	Comando de teclado	Eliminar una clave	`key` : cadena (clave para eliminar)
Zadd	Comando de conjunto ordenado	Agregar uno o más miembros a un conjunto ordenado	`key` : cadena (clave del conjunto ordenado) `members` : matriz de objetos con `score` : número y `value` : cadena
rango z	Comando de conjunto ordenado	Devuelve un rango de miembros de un conjunto ordenado por índice	`key` : 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 zrangeby	Comando de conjunto ordenado	Devuelve miembros de un conjunto ordenado con puntuaciones entre mínima y máxima	`key` : 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)
zrem	Comando de conjunto ordenado	Eliminar uno o más miembros de un conjunto ordenado	`key` : cadena (clave del conjunto ordenado) `members` : matriz de cadenas (miembros a eliminar)
triste	Comando de configuración	Agregar uno o más miembros a un conjunto	`key` : cadena (clave del conjunto) `members` : matriz de cadenas (miembros que se agregarán al conjunto)
miembros	Comando de configuración	Obtener todos los miembros en un conjunto	`key` : 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:

Cree una nueva clase de herramienta en src/tools/ que extienda RedisTool
Define la interfaz de la herramienta en src/interfaces/types.ts
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.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

View all tools

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Redis
GongRzhe
-
security
A
license
-
quality
Provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.
Last updated -
73
17
JavaScript
MIT License
db-mcp-tool
wirdes
A
security
A
license
A
quality
A powerful Model Context Protocol (MCP) tool for exploring and managing different types of databases including PostgreSQL, MySQL, and Firestore.
Last updated -
9
3
TypeScript
MIT License
Redash MCP Server
suthio
A
security
F
license
A
quality
Model Context Protocol (MCP) server that integrates Redash with AI assistants like Claude, allowing them to query data, manage visualizations, and interact with dashboards through natural language.
Last updated -
10
53
16
JavaScript
mcp-dbs
cuongtl1992
-
security
A
license
-
quality
A Model Context Protocol (MCP) implementation for connecting to and working with various database systems.
Last updated -
23
17
TypeScript
MIT License

View all related MCP servers

Redis MCP Server