# mcp-redis-server [Health: Active]

**Category:** 🗄️ Databases  
**Repository:** https://github.com/daedalus/mcp-redis-server  
**GitHub Stars:** 0  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-redis-server

## Description
MCP server that exposes Redis API to AI models

## Tools
Capabilities this server exposes over MCP:

- **redis_connect** — Connect to a Redis server.
- **redis_disconnect** — Disconnect from the Redis server.
- **redis_ping** — Ping the Redis server.
- **redis_get** — Get the value of a key.
- **redis_set** — Set the value of a key.
- **redis_mget** — Get the values of multiple keys.
- **redis_mset** — Set multiple key-value pairs.
- **redis_del** — Delete one or more keys.
- **redis_incr** — Increment the value of a key.
- **redis_decr** — Decrement the value of a key.
- **redis_lpush** — Push values to the left of a list.
- **redis_rpush** — Push values to the right of a list.
- **redis_lrange** — Get a range of elements from a list.
- **redis_llen** — Get the length of a list.
- **redis_sadd** — Add members to a set.
- **redis_srem** — Remove members from a set.
- **redis_smembers** — Get all members of a set.
- **redis_sismember** — Check if a member exists in a set.
- **redis_scard** — Get the size of a set.
- **redis_hset** — Set a field in a hash.
- **redis_hget** — Get a field from a hash.
- **redis_hmset** — Set multiple fields in a hash.
- **redis_hmget** — Get multiple fields from a hash.
- **redis_hgetall** — Get all fields and values from a hash.
- **redis_hkeys** — Get all field names from a hash.
- **redis_hvals** — Get all field values from a hash.
- **redis_hdel** — Delete fields from a hash.
- **redis_hlen** — Get the number of fields in a hash.
- **redis_zadd** — Add members with scores to a sorted set.
- **redis_zscore** — Get the score of a member in a sorted set.
- **redis_zrange** — Get a range of members from a sorted set.
- **redis_zrevrange** — Get a range of members from a sorted set in reverse order.
- **redis_zcard** — Get the size of a sorted set.
- **redis_exists** — Check if keys exist.
- **redis_expire** — Set expiration time on a key.
- **redis_ttl** — Get the time to live for a key.
- **redis_type** — Get the type of a key.
- **redis_scan** — Scan keys matching a pattern.
- **redis_dbsize** — Get the number of keys in the current database.
- **redis_flushdb** — Flush all keys in the current database.
- **redis_flushall** — Flush all keys in all databases.
- **redis_info** — Get Redis server information.
- **redis_config_get** — Get Redis configuration.
- **redis_config_set** — Set Redis configuration.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcp-redis-server": {
    "command": "uvx",
    "args": ["mcp-redis-server"],
    "env": {
      "REDIS_HOST": "",
      "REDIS_PORT": "",
      "REDIS_PASSWORD": "",
      "REDIS_DB": "",
      "REDIS_SSL": ""
    }
  }
}
```

**Requires environment variables:** `REDIS_HOST`, `REDIS_PORT`, `REDIS_PASSWORD`, `REDIS_DB`, `REDIS_SSL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What mcp-redis-server does

The mcp-redis-server MCP server gives an MCP-compatible AI client a tool interface for Redis. Its API covers common Redis data types and several database-management operations, allowing an agent to connect to a Redis instance, read values, write values, inspect keys, and perform selected server queries.

The available operations include string reads and writes, numeric increments and decrements, list insertion and range queries, set membership and cardinality checks, hash field access, and sorted-set ranking operations. Key-oriented tools handle existence checks, expiration, time-to-live values, type inspection, and scanning. Server tools expose database size, Redis information, configuration access, and database-wide clearing commands.

## How it works

After installation, the package exposes a Python MCP object that can be started with its `run()` method. It also provides a command-line entry point. The server connects to Redis using environment-based settings, including the host, port, optional password, database number, and SSL selection.

Operations are presented as separate MCP tools with names such as `redis_get`, `redis_set`, `redis_hgetall`, `redis_lrange`, and `redis_scan`. Connection lifecycle tools are provided separately through `redis_connect`, `redis_disconnect`, and `redis_ping`.

## Setup and configuration

Install the package with:

```bash
pip install mcp-redis-server
```

The documented CLI command is:

```bash
mcp-redis-server
```

The Python usage example imports `mcp` from `mcp_redis_server` and starts it with `mcp.run()`.

Configure the Redis connection with these variables:

- `REDIS_HOST`: Redis hostname; defaults to `localhost`.
- `REDIS_PORT`: Redis port; defaults to `6379`.
- `REDIS_PASSWORD`: Optional Redis password.
- `REDIS_DB`: Redis database number; defaults to `0`.
- `REDIS_SSL`: Enables SSL when set accordingly; the documented default is `false`.

## Tools and capabilities

The mcp-redis-server MCP server groups its tools by Redis feature:

- Connection: connect, disconnect, and ping.
- Strings: get, set, multi-get, multi-set, delete, increment, and decrement.
- Lists: push values from either side, read ranges, and count items.
- Sets: add, remove, list members, test membership, and count members.
- Hashes: set, retrieve, delete, list fields or values, and count fields.
- Sorted sets: add members, read scores, retrieve ranges in either order, and count members.
- Keys: test existence, set expiration, read TTL, inspect types, and scan keys.
- Server: inspect database size and Redis information, read or set configuration, and flush the selected database or all databases.

## Limitations and notes

It also does not state whether destructive commands require confirmation.

The README contains a second usage section with different module, CLI, and repository names (`mcp_redis`, `mcp-redis`, and `daedalus/mcp-redis`) after the primary `mcp_redis_server` and `mcp-redis-server` examples. Use the package installation and entry point matching the project name, and verify the installed interface if the alternate example is relevant. The mcp-redis-server MCP server should therefore be evaluated against the exact Redis commands and operational safeguards required by the deployment.

_Full upstream README: https://allmcps.com/mcp/mcp-redis-server/readme_