mcp/redis repository overview

⁠Redis MCP Server

Access to Redis database operations.

What is an MCP Server?⁠

⁠MCP Info

⁠Image Building Info

Attribute	Details
Dockerfile	https://github.com/redis/mcp-redis/blob/1f35871886f39736a2924cfd5f346eef5adc387b/Dockerfile⁠
Commit	1f35871886f39736a2924cfd5f346eef5adc387b
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/redis --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
Licence	MIT License

⁠Available Tools (45)

⁠Tools Details

⁠Tool: client_list

Get a list of connected clients to the Redis server.

⁠Tool: create_vector_index_hash

Create a Redis 8 vector similarity index using HNSW on a Redis hash.

This function sets up a Redis index for approximate nearest neighbor (ANN) search using the HNSW algorithm and float32 vector embeddings.

⁠Tool: dbsize

Get the number of keys stored in the Redis database

⁠Tool: delete

Delete a Redis key.

⁠Tool: expire

Set an expiration time for a Redis key.

⁠Tool: get

Get a Redis string value.

⁠Tool: get_index_info

Retrieve schema and information about a specific Redis index using FT.INFO.

⁠Tool: get_indexed_keys_number

Retrieve the number of indexed keys by the index

⁠Tool: get_indexes

List of indexes in the Redis database

Returns: str: A JSON string containing the list of indexes or an error message.

⁠Tool: get_vector_from_hash

Retrieve a vector from a Redis hash and convert it back from binary blob.

⁠Tool: hdel

Delete a field from a Redis hash.

⁠Tool: hexists

Check if a field exists in a Redis hash.

⁠Tool: hget

Get the value of a field in a Redis hash.

⁠Tool: hgetall

Get all fields and values from a Redis hash.

⁠Tool: hset

Set a field in a hash stored at key with an optional expiration time.

⁠Tool: info

Get Redis server information and statistics.

⁠Tool: json_del

Delete a JSON value from Redis at a given path.

⁠Tool: json_get

Retrieve a JSON value from Redis at a given path.

⁠Tool: json_set

Set a JSON value in Redis at a given path with an optional expiration time.

⁠Tool: llen

Get the length of a Redis list.

⁠Tool: lpop

Remove and return the first element from a Redis list.

⁠Tool: lpush

Push a value onto the left of a Redis list and optionally set an expiration time.

⁠Tool: lrange

Get elements from a Redis list within a specific range.

Returns: str: A JSON string containing the list of elements or an error message.

⁠Tool: publish

Publish a message to a Redis channel.

⁠Tool: rename

Renames a Redis key from old_key to new_key.

⁠Tool: rpop

Remove and return the last element from a Redis list.

⁠Tool: rpush

Push a value onto the right of a Redis list and optionally set an expiration time.

⁠Tool: sadd

Add a value to a Redis set with an optional expiration time.

⁠Tool: scan_all_keys

Scan and return ALL keys matching a pattern using multiple SCAN iterations.

This function automatically handles the SCAN cursor iteration to collect all matching keys. It's safer than KEYS * for large databases but will still collect all results in memory.

⚠️ WARNING: With very large datasets (millions of keys), this may consume significant memory. For large-scale operations, consider using scan_keys() with manual iteration instead.

⁠Tool: scan_keys

Scan keys in the Redis database using the SCAN command (non-blocking, production-safe).

⚠️ IMPORTANT: This returns PARTIAL results from one iteration. Use scan_all_keys() to get ALL matching keys, or call this function multiple times with the returned cursor until cursor becomes 0.

The SCAN command iterates through the keyspace in small chunks, making it safe to use on large databases without blocking other operations.

⁠Tool: search_redis_documents

Search Redis documentation and knowledge base to learn about Redis concepts and use cases.

This tool exposes updated and curated documentation, and must be invoked every time the user wants to learn more in areas including:

Common Use Cases:

• Session Management: User session storage and management
• Caching: Application-level and database query caching
• Rate Limiting: API throttling and request limiting
• Leaderboards: Gaming and ranking systems
• Semantic Search: AI-powered similarity search
• Agentic Workflows: AI agent state and memory management
• RAG (Retrieval-Augmented Generation): Vector storage for AI applications
• Real-time Analytics: Counters, metrics, and time-series data
• Message Queues: Task queues and job processing
• Geospatial: Location-based queries and proximity search Parameters|Type|Description -|-|- question|string|The question about Redis concepts, data structures, features, or use cases

⁠Tool: set

Set a Redis string value with an optional expiration time.

⁠Tool: set_vector_in_hash

Store a vector as a field in a Redis hash.

⁠Tool: smembers

Get all members of a Redis set.

⁠Tool: srem

Remove a value from a Redis set.

⁠Tool: subscribe

Subscribe to a Redis channel.

⁠Tool: type

Returns the string representation of the type of the value stored at key

⁠Tool: unsubscribe

Unsubscribe from a Redis channel.

⁠Tool: vector_search_hash

Perform a KNN vector similarity search using Redis 8 or later version on vectors stored in hash data structures.

⁠Tool: xadd

Add an entry to a Redis stream with an optional expiration time.

⁠Tool: xdel

Delete an entry from a Redis stream.

⁠Tool: xrange

Read entries from a Redis stream.

⁠Tool: zadd

Add a member to a Redis sorted set with an optional expiration time.

⁠Tool: zrange

Retrieve a range of members from a Redis sorted set.

⁠Tool: zrem

Remove a member from a Redis sorted set.

⁠Use this MCP Server

{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "REDIS_HOST",
        "-e",
        "REDIS_PORT",
        "-e",
        "REDIS_USERNAME",
        "-e",
        "REDIS_SSL",
        "-e",
        "REDIS_CA_PATH",
        "-e",
        "REDIS_SSL_KEYFILE",
        "-e",
        "REDIS_SSL_CERTFILE",
        "-e",
        "REDIS_CERT_REQS",
        "-e",
        "REDIS_CA_CERTS",
        "-e",
        "REDIS_CLUSTER_MODE",
        "-e",
        "REDIS_PWD",
        "mcp/redis"
      ],
      "env": {
        "REDIS_HOST": "127.0.0.1",
        "REDIS_PORT": "6379",
        "REDIS_USERNAME": "default",
        "REDIS_SSL": "False",
        "REDIS_CA_PATH": "",
        "REDIS_SSL_KEYFILE": "",
        "REDIS_SSL_CERTFILE": "",
        "REDIS_CERT_REQS": "required",
        "REDIS_CA_CERTS": "",
        "REDIS_CLUSTER_MODE": "False",
        "REDIS_PWD": ""
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠