MCP-сервер Redis CRUD

Это плагин сервера MCP (Model Context Protocol) для операций с базой данных Redis, предоставляющий полные инструменты CRUD.

✨ Характеристики

• 🔍 Автоматическое обнаружение конфигурации проекта - автоматический поиск файла .env вверх по дереву каталогов для определения корня проекта

• 🔄 Поддержка нескольких проектов - автоматическое использование разных подключений Redis для разных проектов

• ⏱️ Защита от тайм-аута подключения - тайм-аут по умолчанию 10 секунд, настраивается через переменные окружения

• 📝 Различные форматы конфигурации - поддержка форматов INI-секций и KEY=VALUE

• 🛠️ Совместимость с различными инструментами - поддержка Claude Code, Cline, Codex и других

🚀 Быстрый старт

Глобальная установка (рекомендуется)

npm install -g redis-crud-server

Конфигурация MCP

Создайте файл .mcp.json в корне проекта:

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

⚙️ Описание конфигурации

Формат конфигурации 1: INI-секция

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

Формат конфигурации 2: KEY=VALUE

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=your_password

Поддерживаемые имена конфигурации

🔧 Список инструментов

Строковые операции

• redis_set - установка строкового ключа и значения

• redis_get - получение строкового ключа и значения

• redis_del - удаление ключа

• redis_exists - проверка существования ключа

Операции с хэшами

• redis_hset - установка поля хэша

• redis_hget - получение поля хэша

• redis_hgetall - получение всех полей хэша

• redis_hdel - удаление поля хэша

Информация

• redis_info - получение информации о подключении

⏱️ Настройка тайм-аута

Тайм-аут подключения по умолчанию составляет 10 секунд, его можно настроить через переменную окружения:

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

📝 Примеры использования

Установка ключа и значения

redis_set: key=test_key, value=hello_world

Получение ключа и значения

redis_get: key=test_key

Операции с хэшами

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

🐛 Устранение неполадок

Тайм-аут подключения

• Проверьте сетевое подключение и настройки брандмауэра

• Убедитесь, что сервер Redis доступен

• Настройте переменную окружения REDIS_TIMEOUT

Файл конфигурации не найден

• Убедитесь, что файл .env находится в корне проекта

• MCP автоматически ищет файл .env вверх по дереву каталогов

Ошибка разбора формата INI

• Убедитесь, что используется правильное имя секции [REDIS]

• Поддерживаются символы переноса строк Windows (\r\n), Unix (\n) и старых Mac (\r)

📄 Лицензия

MIT