A Redis Model Context Protocol (MCP) server implementation that enables LLMs to interact with Redis key-value stores through standardized tools for database operations.

Installation

Smithery

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

NPX

npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port

NPM Global

npm install -g @gongrzhe/server-redis-mcp@1.0.0
@gongrzhe/server-redis-mcp redis://your-redis-host:port

Docker

docker build -t mcp/redis .

From Source

npm install
npm run build

Configuration

Claude Desktop (NPX)

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-redis-mcp@1.0.0",
        "redis://localhost:6379"
      ]
    }
  }
}

Claude Desktop (Node)

{
  "mcpServers": {
    "redis": {
      "command": "node",
      "args": [
        "path/to/build/index.js",
        "redis://10.1.210.223:6379"
      ]
    }
  }
}

Claude Desktop (Docker)

{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/redis", 
        "redis://host.docker.internal:6379"
      ]
    }
  }
}

Available Tools

Tool	Description
set	Sets a key-value pair in Redis with optional expiration time in seconds
get	Retrieves a value by key from Redis
delete	Deletes one or multiple keys from Redis
list	Lists Redis keys matching a pattern (default: *)

Features

• Key-value store operations in Redis
• Optional expiration time setting for keys
• List and search keys by pattern
• Support for deleting multiple keys
• Docker container support with host network access
• 62 Redis MCP tools available in the redis-plus branch

Notes

The server supports Redis URL configuration and defaults to redis://localhost:6379. For Docker usage on macOS, use host.docker.internal if Redis is running on the host network. An extended version with 62 Redis MCP tools is available in the redis-plus branch.