Redis MCP Server

A Model Context Protocol (MCP) server for Redis. Connect to any Redis instance and execute queries through AI assistants.

Features

• 🔌 Connect to any Redis instance - Local or remote, with authentication and TLS support

• 🛠️ 30+ Built-in Tools - Complete Redis operations including strings, hashes, lists, sets, sorted sets

• 🔒 Command Blacklist - Block dangerous commands (FLUSHALL, SHUTDOWN, etc.)

• 💾 Connection Management - Save and switch between multiple Redis connections

• 🌐 Web UI - Browser-based management interface

• 🔐 Password Encryption - AES-256-GCM encryption for saved passwords

Related MCP server: Redash MCP Server

Screenshots

Installation

1. Clone the repository

git clone https://github.com/minivv/redis-mcp-server.git
cd redis-mcp-server

2. Install dependencies and build

npm install
npm run build

3. Configure MCP Client

Add to your Claude Desktop, Cursor, or other MCP client configuration:

{
  "mcpServers": {
    "redis-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/your/path/to/redis-mcp-server/build/index.js"
      ],
      "env": {
        "MCP_OPEN_BROWSER": "false",
        "REDIS_HOST": "127.0.0.1",
        "REDIS_PORT": "6379",
        "REDIS_PASSWORD": "",
        "REDIS_DB": "0"
      }
    }
  }
}

⚠️ 注意: 请将 args 中的路径 /your/path/to/redis-mcp-server/build/index.js 改为你本机实际的项目路径，例如 /Users/yourname/projects/redis-mcp-server/build/index.js。

Environment Variables

Available Tools

Connection Management

Query Execution

Key Operations

String Operations

Hash Operations

List Operations

Set Operations

Sorted Set Operations

Database Operations

Blacklist Management

Command Blacklist

By default, the following commands are blocked:

• FLUSHALL - Flush all databases

• FLUSHDB - Flush current database

• SHUTDOWN - Shutdown Redis server

• DEBUG SEGFAULT - Debug segfault

• CONFIG SET - Change Redis config

• CONFIG REWRITE - Rewrite Redis config

• SLAVEOF - Set replication

• REPLICAOF - Set replication

• CLUSTER * - Cluster commands

• RESET - Reset connection

You can customize the blacklist through the Web UI or using the update_command_blacklist tool.

Web UI

The Web UI provides a browser-based interface for:

• Managing Redis connections

• Testing connections

• Managing the command blacklist

• Testing commands against the blacklist

Access it at http://localhost:3457 (default port).

Configuration Storage

All configuration is stored in ~/.redis-mcp/:

• connections.json - Saved connections

• command-blacklist.json - Command blacklist rules

• .key - Encryption key for passwords

Security

• Passwords are encrypted using AES-256-GCM

• Dangerous commands are blocked by default

• The encryption key is stored with restricted permissions (0600)

License

MIT