Redis

You can interact with Redis key-value stores through a dedicated MCP server that exposes simple tools for setting, retrieving, deleting, and listing keys. This MCP server lets large language models issue these common Redis operations in a structured, standardized way, making Redis data accessible from your MCP-enabled clients.

How to use

You connect to the Redis MCP Server from your MCP client and use the provided tools to manage Redis data. The available tools are designed to be intuitive and cover the essential operations you need: set—store a value with an optional expiration; get—retrieve a value by key; delete—remove one or more keys; and list—find keys that match a pattern. Use these tools to build queries, automate data workflows, or enable your agents to read and modify Redis data as part of larger tasks.

How to install

Prerequisites: you need Node.js and npm (or npx) installed on your system. You may also run the server via Docker if you prefer containers.

# Installing via Smithery ( Claude Desktop client )
npx -y @smithery/cli install @gongrzhe/server-redis-mcp --client claude

# Installing Manually with a Redis URL (recommended for quick starts)
npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port

# Or install globally and run
npm install -g @gongrzhe/server-redis-mcp@1.0.0

# Run after global installation
@gongrzhe/server-redis-mcp redis://your-redis-host:port

Configuration examples

Configure your MCP client to use the Redis MCP Server by providing a stdio-based setup. You can run the MCP server via npx, or directly with node if you have the package installed, or via Docker. The examples below show how to wire the MCP server into your client configuration.

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

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

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

Available tools

set

Store a Redis key-value pair with an optional expiration. Provide the key, value, and an optional expireSeconds to automatically remove the key after the specified duration.

get

Retrieve the value for a given key from Redis.

delete

Delete one or more keys from Redis. You can specify a single key or a list of keys to remove.

list

List keys that match a given pattern, enabling you to discover and manage related keys in Redis.