Servidor MCP de Redis

Descripción general

El servidor MCP de Redis es una interfaz de lenguaje natural diseñada para que las aplicaciones de agencia gestionen y busquen datos eficientemente en Redis. Se integra a la perfección con los clientes MCP (Protocolo de Contenido de Modelo) , lo que permite que los flujos de trabajo basados en IA interactúen con datos estructurados y no estructurados en Redis. Con este servidor MCP, puede realizar preguntas como:

"Guarda toda la conversación en un stream"
"Guardar este elemento en caché"
"Guardar la sesión con un tiempo de expiración"
"Indexar y buscar este vector"

Características

Consultas en lenguaje natural : permite que los agentes de IA consulten y actualicen Redis utilizando lenguaje natural.
Integración perfecta con MCP : funciona con cualquier cliente MCP para una comunicación fluida.
Compatibilidad total con Redis : maneja hashes, listas, conjuntos, conjuntos ordenados, transmisiones y más.
Búsqueda y filtrado : admite la recuperación y búsqueda de datos eficiente en Redis.
Escalable y liviano : diseñado para operaciones de datos de alto rendimiento .

Herramientas

Este servidor MCP proporciona herramientas para administrar los datos almacenados en Redis.

Herramientas string para configurar y obtener cadenas con vencimiento. Útiles para almacenar valores de configuración simples, datos de sesión o respuestas en caché.
Herramientas hash para almacenar pares campo-valor en una sola clave. El hash puede almacenar incrustaciones vectoriales. Resulta útil para representar objetos con múltiples atributos, perfiles de usuario o información de producto donde se puede acceder a los campos individualmente.
Herramientas list con operaciones comunes para añadir y extraer elementos. Útiles para colas, intermediarios de mensajes o para mantener una lista de las acciones más recientes.
set para agregar, eliminar y listar miembros del conjunto. Útiles para rastrear valores únicos, como identificadores de usuario o etiquetas, y para realizar operaciones de conjunto como la intersección.
herramientas sorted set para administrar datos, por ejemplo, tablas de clasificación, colas de prioridad o análisis basados en el tiempo con ordenamiento basado en puntuación.
Función pub/sub para publicar mensajes en canales y suscribirse para recibirlos. Útil para notificaciones en tiempo real, aplicaciones de chat o para distribuir actualizaciones a múltiples clientes.
Herramientas streams para agregar, leer y eliminar datos de flujos. Útiles para la generación de eventos, feeds de actividad o registro de datos de sensores con compatibilidad con grupos de consumidores.
Herramientas JSON para almacenar, recuperar y manipular documentos JSON en Redis. Útiles para estructuras de datos anidadas complejas, bases de datos de documentos o gestión de configuración con acceso basado en rutas.

Herramientas adicionales.

Herramientas query engine para administrar índices vectoriales y realizar búsquedas vectoriales
Herramienta server management para recuperar información sobre la base de datos.

Instalación

Siga estas instrucciones para instalar el servidor.

# Clone the repository
git clone https://github.com/redis/mcp-redis.git
cd mcp-redis

# Install dependencies using uv
uv venv
source .venv/bin/activate
uv sync

Configuración

Para configurar este servidor Redis MCP, tenga en cuenta las siguientes variables de entorno:

Nombre	Descripción	Valor predeterminado
`REDIS_HOST`	IP o nombre de host de Redis	`"127.0.0.1"`
`REDIS_PORT`	Puerto Redis	`6379`
`REDIS_USERNAME`	Nombre de usuario de la base de datos predeterminada	`"default"`
`REDIS_PWD`	Contraseña de base de datos predeterminada	""
`REDIS_SSL`	Habilita o deshabilita SSL/TLS	`False`
`REDIS_CA_PATH`	Certificado CA para verificar el servidor	Ninguno
`REDIS_SSL_KEYFILE`	Archivo de clave privada del cliente para la autenticación del cliente	Ninguno
`REDIS_SSL_CERTFILE`	Archivo de certificado del cliente para la autenticación del cliente	Ninguno
`REDIS_CERT_REQS`	Si el cliente debe verificar el certificado del servidor	`"required"`
`REDIS_CA_CERTS`	Ruta al archivo de certificados de CA de confianza	Ninguno
`REDIS_CLUSTER_MODE`	Habilitar el modo Redis Cluster	`False`
`MCP_TRANSPORT`	Utilice el transporte `stdio` o `sse`	`stdio`

Transportes

Este servidor MCP puede configurarse para gestionar solicitudes localmente, ejecutándose como un proceso y comunicándose con el cliente MCP mediante stdin y stdout . Esta es la configuración predeterminada. El transporte sse también es configurable para que el servidor esté disponible en la red. Configure la variable MCP_TRANSPORT como corresponda.

export MCP_TRANSPORT="sse"

Luego inicia el servidor.

uv run src/main.py

Probar el servidor:

curl -i http://127.0.0.1:8000/sse
HTTP/1.1 200 OK

Integra con tu herramienta o cliente favorito. La configuración de VS Code para GitHub Copilot es:

"mcp": {
    "servers": {
        "redis-mcp": {
            "type": "sse",
            "url": "http://127.0.0.1:8000/sse"
        },
    }
},

Integración con el SDK de OpenAI Agents

Integre este servidor MCP con el SDK de OpenAI Agents. Consulte la documentación para obtener más información sobre la integración del SDK con MCP.

Instalar el SDK de Python.

pip install openai-agents

Configurar el token OpenAI:

export OPENAI_API_KEY="<openai_token>"

Y ejecuta la aplicación .

python3.13 redis_assistant.py

Puede solucionar problemas en los flujos de trabajo de sus agentes utilizando el panel de OpenAI .

Integración con Claude Desktop

Vía Smithery

Si desea probar el servidor Redis MCP implementado por Smithery , puede configurar Claude Desktop automáticamente:

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

Siga las instrucciones y proporcione los detalles para configurar el servidor y conectarse a Redis (por ejemplo, usando una base de datos de Redis Cloud). El procedimiento creará la configuración correcta en el archivo de configuración claude_desktop_config.json .

Configuración manual

Puede configurar Claude Desktop para utilizar este servidor MCP.

Especifique sus credenciales de Redis y la configuración de TLS
Recupere la ruta completa de su comando uv (por ejemplo, which uv )
Editar el archivo de configuración claude_desktop_config.json
- en un MacOS, en ~/Library/Application\ Support/Claude/

{
    "mcpServers": {
        "redis": {
            "command": "<full_path_uv_command>",
            "args": [
                "--directory",
                "<your_mcp_server_directory>",
                "run",
                "src/main.py"
            ],
            "env": {
                "REDIS_HOST": "<your_redis_database_hostname>",
                "REDIS_PORT": "<your_redis_database_port>",
                "REDIS_PWD": "<your_redis_database_password>",
                "REDIS_SSL": True|False,
                "REDIS_CA_PATH": "<your_redis_ca_path>",
                "REDIS_CLUSTER_MODE": True|False
            }
        }
    }
}

Uso con Docker

Puedes usar una implementación dockerizada de este servidor. Puedes crear tu propia imagen o usar la imagen oficial de Redis MCP Docker .

Si desea crear su propia imagen, el servidor Redis MCP proporciona un Dockerfile. Cree la imagen de este servidor con:

docker build -t mcp-redis .

Finalmente, configure Claude Desktop para crear el contenedor al iniciar. Edite el claude_desktop_config.json y agregue:

{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": ["run",
                "--rm",
                "--name",
                "redis-mcp-server",
                "-i",
                "-e", "REDIS_HOST=<redis_hostname>",
                "-e", "REDIS_PORT=<redis_port>",
                "-e", "REDIS_USERNAME=<redis_username>",
                "-e", "REDIS_PWD=<redis_password>",
                "mcp-redis"]
    }
  }
}

Para utilizar la imagen Docker oficial de Redis MCP , simplemente reemplace el nombre de su imagen ( mcp-redis en el ejemplo anterior) con mcp/redis .

Solución de problemas

Puedes solucionar problemas siguiendo el archivo de registro.

tail -f ~/Library/Logs/Claude/mcp-server-redis.log

Integración con VS Code

Para utilizar el servidor Redis MCP con VS Code, necesita:

Habilite las herramientas del modo agente . Agregue lo siguiente a su settings.json :

{
  "chat.agent.enabled": true
}

Agregue la configuración del servidor Redis MCP a su mcp.json o settings.json :

// Example .vscode/mcp.json
{
  "servers": {
    "redis": {
      "type": "stdio",
      "command": "<full_path_uv_command>",
      "args": [
        "--directory",
        "<your_mcp_server_directory>",
        "run",
        "src/main.py"
      ],
      "env": {
        "REDIS_HOST": "<your_redis_database_hostname>",
        "REDIS_PORT": "<your_redis_database_port>",
        "REDIS_USERNAME": "<your_redis_database_username>",
        "REDIS_PWD": "<your_redis_database_password>",
      }
    }
  }
}

// Example settings.json
{
  "mcp": {
    "servers": {
      "redis": {
        "type": "stdio",
        "command": "<full_path_uv_command>",
        "args": [
          "--directory",
          "<your_mcp_server_directory>",
          "run",
          "src/main.py"
        ],
        "env": {
          "REDIS_HOST": "<your_redis_database_hostname>",
          "REDIS_PORT": "<your_redis_database_port>",
          "REDIS_USERNAME": "<your_redis_database_username>",
          "REDIS_PWD": "<your_redis_database_password>",
        }
      }
    }
  }
}

Para obtener más información, consulte la documentación de VS Code .

Pruebas

Puede utilizar el Inspector MCP para la depuración visual de este servidor MCP.

npx @modelcontextprotocol/inspector uv run src/main.py

Ejemplos de casos de uso

Asistentes de IA : permiten que los LLM obtengan, almacenen y procesen datos en Redis.
Chatbots y agentes virtuales : recupere datos de sesión, administre colas y personalice respuestas.
Búsqueda y análisis de datos : consulte Redis para obtener información en tiempo real y búsquedas rápidas .
Procesamiento de eventos : administre flujos de eventos con Redis Streams .

Contribuyendo

Bifurcar el repositorio
Crear una nueva rama ( feature-branch )
Confirme sus cambios
¡Envíalo a tu sucursal y envía un PR!

Licencia

Este proyecto está licenciado bajo la licencia MIT .

Insignias

Contacto

Si tiene preguntas o necesita ayuda, comuníquese a través de Problemas de GitHub .

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

El servidor oficial Redis MCP es una interfaz de lenguaje natural diseñada para que las aplicaciones de agencia administren y busquen datos de manera eficiente en Redis.

Related MCP Servers

Redis MCP Server
farhankaz
A
security
A
license
A
quality
Enables users to perform Redis database operations using the Model Context Protocol (MCP) tools, allowing for efficient data management through commands like setting, getting, and scanning hash fields.
Last updated -
13
29
5
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
Zanny's Persistent Memory Manager
zannyonear1h1
-
security
F
license
-
quality
A custom MCP server that allows storage, retrieval, and management of text-based information with natural language commands and keyword detection.
Last updated -
TypeScript
Agora MCP
Fewsats
-
security
F
license
-
quality
An MCP server that connects AI assistants to SearchAgora, enabling users to search for, discover, and purchase products across the web through natural language conversations.
Last updated -
1
Python

View all related MCP servers

Redis MCP Server