Servidor MCP de CRUD para Redis

Este es un complemento de servidor MCP (Model Context Protocol) para operaciones de base de datos Redis, que proporciona herramientas completas de operaciones CRUD.

✨ Características

• 🔍 Detección automática de configuración del proyecto - Busca automáticamente archivos .env hacia arriba para localizar la raíz del proyecto

• 🔄 Soporte para múltiples proyectos - Diferentes proyectos utilizan automáticamente diferentes conexiones de Redis

• ⏱️ Protección contra tiempo de espera de conexión - Tiempo de espera predeterminado de 10 segundos, configurable mediante variables de entorno

• 📝 Múltiples formatos de configuración - Admite formatos INI section y KEY=VALUE

• 🛠️ Compatible con múltiples herramientas - Admite Claude Code, Cline, Codex, etc.

🚀 Inicio rápido

Instalación global (recomendado)

npm install -g redis-crud-server

Configuración de MCP

Cree un archivo .mcp.json en la raíz del proyecto:

{
  "mcpServers": {
    "redis-crud": {
      "command": "redis-crud-server"
    }
  }
}

⚙️ Instrucciones de configuración

Formato de configuración uno: formato INI Section

[REDIS]
REDIS_HOSTNAME = 127.0.0.1
PORT = 6379
REDIS_PASSWORD = your_password
SELECT = 0

Formato de configuración dos: formato KEY=VALUE

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=your_password

Nombres de configuración admitidos

🔧 Lista de herramientas

Operaciones de cadena

• redis_set - Establecer clave-valor de cadena

• redis_get - Obtener clave-valor de cadena

• redis_del - Eliminar clave

• redis_exists - Comprobar si existe la clave

Operaciones de hash

• redis_hset - Establecer campo de hash

• redis_hget - Obtener campo de hash

• redis_hgetall - Obtener todos los campos de hash

• redis_hdel - Eliminar campo de hash

Información

• redis_info - Obtener información de conexión

⏱️ Configuración de tiempo de espera

El tiempo de espera de conexión predeterminado es de 10 segundos, configurable mediante variables de entorno:

{
  "mcpServers": {
    "redis-crud": {
      "command": "redis-crud-server",
      "env": {
        "REDIS_TIMEOUT": "30000"
      }
    }
  }
}

📝 Ejemplos de uso

Establecer clave-valor

redis_set: key=test_key, value=hello_world

Obtener clave-valor

redis_get: key=test_key

Operaciones de hash

redis_hset: key=user:1, field=name, value=张三
redis_hget: key=user:1, field=name
redis_hgetall: key=user:1

🐛 Solución de problemas

Tiempo de espera de conexión

• Compruebe la conexión de red y la configuración del firewall

• Confirme que el servidor Redis sea accesible

• Ajuste la variable de entorno REDIS_TIMEOUT

Archivo de configuración no encontrado

• Asegúrese de que el archivo .env esté en la raíz del proyecto

• MCP buscará automáticamente el archivo .env hacia arriba

Error de análisis de formato INI

• Asegúrese de usar el nombre de sección correcto [REDIS]

• Admite saltos de línea de Windows (\r\n), Unix (\n) y Mac antiguo (\r)

📄 Licencia

MIT