Redis CRUD MCP Server

This is an MCP (Model Context Protocol) server plugin for Redis database operations, providing a full suite of CRUD tools.

✨ Features

• 🔍 Automatic Project Configuration Detection - Automatically searches upwards for .env files to locate the project root directory

• 🔄 Multi-Project Support - Automatically uses different Redis connections for different projects

• ⏱️ Connection Timeout Protection - 10-second default timeout, configurable via environment variables

• 📝 Multiple Configuration Formats - Supports both INI section and KEY=VALUE formats

• 🛠️ Multi-Tool Compatibility - Supports Claude Code, Cline, Codex, etc.

Related MCP server: MCP Server Redis

🚀 Quick Start

Global Installation (Recommended)

npm install -g redis-crud-server

MCP Configuration

Create a .mcp.json file in your project root:

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

⚙️ Configuration Guide

Configuration Format 1: INI Section Format

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

Configuration Format 2: KEY=VALUE Format

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=your_password

Supported Configuration Names

🔧 Tool List

String Operations

• redis_set - Set string key-value

• redis_get - Get string key-value

• redis_del - Delete key

• redis_exists - Check if key exists

Hash Operations

• redis_hset - Set hash field

• redis_hget - Get hash field

• redis_hgetall - Get all hash fields

• redis_hdel - Delete hash field

Information

• redis_info - Get connection information

⏱️ Timeout Configuration

The default connection timeout is 10 seconds, which can be configured via environment variables:

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

📝 Usage Examples

Set Key-Value

redis_set: key=test_key, value=hello_world

Get Key-Value

redis_get: key=test_key

Hash Operations

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

🐛 Troubleshooting

Connection Timeout

• Check network connection and firewall settings

• Confirm the Redis server is accessible

• Adjust the REDIS_TIMEOUT environment variable

Configuration File Not Found

• Ensure the .env file is in the project root directory

• MCP will automatically search upwards for the .env file

INI Format Parsing Failure

• Ensure the correct section name [REDIS] is used

• Supports Windows (\r\n), Unix (\n), and legacy Mac (\r) line endings

📄 License

MIT