热门搜索:
mcp/redis
提供Redis数据库操作访问能力，支持44种工具，包括键管理、数据结构操作、向量索引创建及相似度搜索等，基于Model Context Protocol (MCP) 实现安全高效的Redis交互。
Redis MCP Server
Access to Redis database operations.
What is an MCP Server?
MCP Info
| Attribute | Details |
|---|---|
| Docker Image | https://hub.docker.com/repository/docker/mcp/redis |
| Author | https://github.com/redis |
| Repository | https://github.com/redis/mcp-redis |
Image Building Info
| Attribute | Details |
|---|---|
| Dockerfile | https://github.com/redis/mcp-redis/blob/1fb3282c58a1be66d2777e75a50757f0de8f89bd/Dockerfile |
| Commit | 1fb3282c58a1be66d2777e75a50757f0de8f89bd |
| Docker Image built by | Docker Inc. |
| Docker Scout Health Score | !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 (51)
| Tools provided by this Server | Short Description |
|---|---|
client_list | Get a list of connected clients to the Redis server. |
create_vector_index_hash | Create a Redis 8 vector similarity index using HNSW on a Redis hash. |
dbsize | Get the number of keys stored in the Redis database |
delete | Delete a Redis key. |
expire | Set an expiration time for a Redis key. |
get | Get a Redis string value. |
get_index_info | Retrieve schema and information about a specific Redis index using FT.INFO. |
get_indexed_keys_number | Retrieve the number of indexed keys by the index |
get_indexes | List of indexes in the Redis database |
get_vector_from_hash | Retrieve a vector from a Redis hash and convert it back from binary blob. |
hdel | Delete a field from a Redis hash. |
hexists | Check if a field exists in a Redis hash. |
hget | Get the value of a field in a Redis hash. |
hgetall | Get all fields and values from a Redis hash. |
hset | Set a field in a hash stored at key with an optional expiration time. |
hybrid_search | Perform a hybrid search combining a Redis filter expression with KNN vector similarity. |
info | Get Redis server information and statistics. |
json_del | Delete a JSON value from Redis at a given path. |
json_get | Retrieve a JSON value from Redis at a given path. |
json_set | Set a JSON value in Redis at a given path with an optional expiration time. |
llen | Get the length of a Redis list. |
lpop | Remove and return the first element from a Redis list. |
lpush | Push a value onto the left of a Redis list and optionally set an expiration time. |
lrange | Get elements from a Redis list within a specific range. |
lrem | Remove elements from a Redis list. |
publish | Publish a message to a Redis channel. |
rename | Renames a Redis key from old_key to new_key. |
rpop | Remove and return the last element from a Redis list. |
rpush | Push a value onto the right of a Redis list and optionally set an expiration time. |
sadd | Add a value to a Redis set with an optional expiration time. |
scan_all_keys | Scan and return ALL keys matching a pattern using multiple SCAN iterations. |
scan_keys | Scan keys in the Redis database using the SCAN command (non-blocking, production-safe). |
search_redis_documents | Search Redis documentation and knowledge base to learn about Redis concepts and use cases. |
set | Set a Redis string value with an optional expiration time. |
set_vector_in_hash | Store a vector as a field in a Redis hash. |
smembers | Get all members of a Redis set. |
srem | Remove a value from a Redis set. |
subscribe | Subscribe to a Redis channel. |
type | Returns the string representation of the type of the value stored at key |
unsubscribe | Unsubscribe from a Redis channel. |
vector_search_hash | Perform a KNN vector similarity search using Redis 8 or later version on vectors stored in hash data structures. |
xack | Acknowledge entries that were processed by a consumer group. |
xadd | Add an entry to a Redis stream with an optional expiration time. |
xdel | Delete an entry from a Redis stream. |
xgroup_create | Create a consumer group for a Redis stream. |
xgroup_destroy | Destroy a consumer group for a Redis stream. |
xrange | Read entries from a Redis stream. |
xreadgroup | Read entries from a Redis stream using a consumer group. |
zadd | Add a member to a Redis sorted set with an optional expiration time. |
zrange | Retrieve a range of members from a Redis sorted set. |
zrem | Remove a member from a Redis sorted set. |
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.
| Parameters | Type | Description |
|---|---|---|
dim | integer optional | The dimensionality of the vectors stored under the vector_field. |
distance_metric | string optional | The distance function to use (e.g., 'COSINE', 'L2', 'IP'). |
index_name | string optional | The name of the Redis index to create. Unless specifically required, use the default name for the index. |
prefix | string optional | The key prefix used to identify documents to index (e.g., 'doc:'). Unless specifically required, use the default prefix. |
vector_field | string optional | The name of the vector field to be indexed for similarity search. Unless specifically required, use the default field name |
Tool: dbsize
Get the number of keys stored in the Redis database
Tool: delete
Delete a Redis key.
| Parameters | Type | Description |
|---|---|---|
key | string |
Tool: expire
Set an expiration time for a Redis key.
| Parameters | Type | Description |
|---|---|---|
expire_seconds | integer | Time in seconds after which the key should expire. |
name | string | The Redis key. |
Tool: get
Get a Redis string value.
| Parameters | Type | Description |
|---|---|---|
key | string |
Tool: get_index_info
Retrieve schema and information about a specific Redis index using FT.INFO.
| Parameters | Type | Description |
|---|---|---|
index_name | string |
Tool: get_indexed_keys_number
Retrieve the number of indexed keys by the index
| Parameters | Type | Description |
|---|---|---|
index_name | string |
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.
| Parameters | Type | Description |
|---|---|---|
name | string | The Redis hash key. |
vector_field | string optional | The field name inside the hash. Unless specifically required, use the default field name |
Tool: hdel
Delete a field from a Redis hash.
| Parameters | Type | Description |
|---|---|---|
key | string | The field name inside the hash. |
name | string | The Redis hash key. |
Tool: hexists
Check if a field exists in a Redis hash.
| Parameters | Type | Description |
|---|---|---|
key | string | The field name inside the hash. |
name | string | The Redis hash key. |
Tool: hget
Get the value of a field in a Redis hash.
| Parameters | Type | Description |
|---|---|---|
key | string | The field name inside the hash. |
name | string | The Redis hash key. |
Tool: hgetall
Get all fields and values from a Redis hash.
| Parameters | Type | Description |
|---|---|---|
name | string | The Redis hash key. |
Tool: hset
Set a field in a hash stored at key with an optional expiration time.
| Parameters | Type | Description |
|---|---|---|
key | string | The field name inside the hash. |
name | string | The Redis hash key. |
value | string | The value to set. |
expire_seconds | string optional | Optional; time in seconds after which the key should expire. |
Tool: hybrid_search
Perform a hybrid search combining a Redis filter expression with KNN vector similarity.
Hybrid search pre-filters documents by metadata before ranking by vector similarity — the standard pattern for production RAG and semantic search pipelines.
Filter expression examples: "*" → no filter, pure vector search (same as vector_search_hash) "@category:{news}" → tag filter "@year:[2020 2024]" → numeric range "@lang:{en} @year:[2022 +inf]" → combined tag + range "@title:redis" → full-text match on a text field
Full filter syntax: [***]
| Parameters | Type | Description |
|---|---|---|
query_vector | array | List of floats to use as the query vector. |
filter_expression | string optional | Redis filter expression to restrict candidates before KNN ranking. |
index_name | string optional | Name of the Redis index (default: 'vector_index'). |
k | integer optional | Number of nearest neighbors to return. |
return_fields | string optional | Additional fields to include in results (optional). |
vector_field | string optional | Name of the indexed vector field (default: 'vector'). |
Tool: info
Get Redis server information and statistics.
| Parameters | Type | Description |
|---|---|---|
section | string optional | The section of the info command (default, memory, cpu, etc.). |
Tool: json_del
Delete a JSON value from Redis at a given path.
| Parameters | Type | Description |
|---|---|---|
name | string | The Redis key where the JSON document is stored. |
path | string optional | The JSON path to delete (default: root '$'). |
Tool: json_get
Retrieve a JSON value from Redis at a given path.
| Parameters | Type | Description |
|---|---|---|
name | string | The Redis key where the JSON document is stored. |
path | string optional | The JSON path to retrieve (default: root '$'). |
Tool: json_set
Set a JSON value in Redis at a given path with an optional expiration time.
| Parameters | Type | Description |
|---|---|---|
name | string | The Redis key where the JSON document is stored. |
path | string | The JSON path where the value should be set. |
value | string | The JSON value to store (as JSON string, or will be auto-converted). |
expire_seconds | string optional | Optional; time in seconds after which the key should expire. |
Tool: llen
Get the length of a Redis list.
| Parameters | Type | Description |
|---|---|---|
name | string |
Tool: lpop
Remove and return the first element from a Redis list.
| Parameters | Type | Description |
|---|---|---|
name | string |
Tool: lpush
Push a value onto the left of a Redis list and optionally set an expiration time.
| Parameters | Type | Description |
|---|---|---|
name | string | |
value | string | |
expire | string optional |
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.
| Parameters | Type | Description |
|---|---|---|
name | string | |
start | integer | |
stop | integer |
Tool: lrem
Remove elements from a Redis list.
| Parameters | Type | Description |
|---|---|---|
count | integer | Number of elements to remove (0 = all, positive = from head, negative = from tail) |
element | string | The element value to remove |
name | string | The name of the list |
Tool: publish
Publish a message to a Redis channel.
| Parameters | Type | Description |
|---|---|---|
channel | string | The Redis channel to publish to. |
message | string | The message to send. |
Tool: rename
Renames a Redis key from old_key to new_key.
| Parameters | Type | Description |
|---|---|---|
new_key | string | |
old_key | string |
Tool: rpop
Remove and return the last element from a Redis list.
| Parameters | Type | Description |
|---|---|---|
name | string |
Tool: rpush
Push a value onto the right of a Redis list and optionally set an expiration time.
| Parameters | Type | Description |
|---|---|---|
name | string | |
value | string | |
expire | string optional |
Tool: sadd
Add a value to a Redis set with an optional expiration time.
| Parameters | Type | Description |
|---|---|---|
name | string | The Redis set key. |
value | string | The value to add to the set. |
expire_seconds | string optional | Optional; time in seconds after which the set should expire. |
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, *** using scan_keys() with manual iteration instead.
| Parameters | Type | Description |
|---|---|---|
batch_size | integer optional | Number of keys to scan per iteration (default 100). |
pattern | string optional | Pattern to match keys against (default is "*" for all keys). |
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.
| Parameters | Type | Description |
|---|---|---|
count | integer optional | Hint for the number of keys to return per iteration (default 100). |
cursor | integer optional | The cursor position to start scanning from (0 to start from beginning). |
pattern | string optional | Pattern to match keys against (default is "*" for all keys). |
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.
| Parameters | Type | Description |
|---|---|---|
key | string | |
value | string | |
expiration | string optional |
Tool: set_vector_in_hash
Store a vector as a field in a Redis hash.
| Parameters | Type | Description |
|---|---|---|
name | string | The Redis hash key. |
vector | array | The vector (list of numbers) to store in the hash. |
vector_field | string optional | The field name inside the hash. Unless specifically required, use the default field name |
Tool: smembers
Get all members of a Redis set.
| Parameters | Type | Description |
|---|---|---|
name | string | The Redis set key. |
Tool: srem
Remove a value from a Redis set.
| Parameters | Type | Description |
|---|---|---|
name | string | The Redis set key. |
value | string | The value to remove from the set. |
Tool: subscribe
Subscribe to a Redis channel.
| Parameters | Type | Description |
|---|---|---|
channel | string | The Redis channel to subscribe to. |
Tool: type
Returns the string representation of the type of the value stored at key
| Parameters | Type | Description |
|---|---|---|
key | string |
Tool: unsubscribe
Unsubscribe from a Redis channel.
| Parameters | Type | Description |
|---|---|---|
channel | string | The Redis channel to unsubscribe from. |
Tool: vector_search_hash
Perform a KNN vector similarity search using Redis 8 or later version on vectors stored in hash data structures.
| Parameters | Type | Description |
|---|---|---|
query_vector | array | List of floats to use as the query vector. |
index_name | string optional | Name of the Redis index. Unless specifically specified, use the default index name. |
k | integer optional | Number of nearest neighbors to return. |
return_fields | string optional | List of fields to return (optional). |
vector_field | string optional | Name of the indexed vector field. Unless specifically required, use the default field name |
Tool: xack
Acknowledge entries that were processed by a consumer group.
| Parameters | Type | Description |
|---|---|---|
entry_ids | array | |
group_name | string | |
key | string |
Tool: xadd
Add an entry to a Redis stream with an optional expiration time.
| Parameters | Type | Description |
|---|---|---|
fields | object | |
key | string | |
expiration | string optional |
Tool: xdel
Delete an entry from a Redis stream.
| Parameters | Type | Description |
|---|---|---|
entry_id | string | |
key | string |
Tool: xgroup_create
Create a consumer group for a Redis stream.
| Parameters | Type | Description |
|---|---|---|
group_name | string | |
key | string | |
mkstream | boolean optional | |
start_id | string optional |
Tool: xgroup_destroy
Destroy a consumer group for a Redis stream.
| Parameters | Type | Description |
|---|---|---|
group_name | string | |
key | string |
Tool: xrange
Read entries from a Redis stream.
| Parameters | Type | Description |
|---|---|---|
key | string | |
count | integer optional |
Tool: xreadgroup
Read entries from a Redis stream using a consumer group.
| Parameters | Type | Description |
|---|---|---|
consumer_name | string | |
group_name | string | |
key | string | |
block_ms | string optional | |
count | integer optional | |
stream_id | string optional |
Tool: zadd
Add a member to a Redis sorted set with an optional expiration time.
| Parameters | Type | Description |
|---|---|---|
key | string | |
member | string | |
score | number | |
expiration | string optional |
Tool: zrange
Retrieve a range of members from a Redis sorted set.
| Parameters | Type | Description |
|---|---|---|
end | integer | |
key | string | |
start | integer | |
with_scores | boolean optional |
Tool: zrem
Remove a member from a Redis sorted set.
| Parameters | Type | Description |
|---|---|---|
key | string | |
member | string |
Use this MCP Server
json{ "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?
更多相关 Docker 镜像与资源
以下是 mcp/redis 相关的常用 Docker 镜像，适用于 缓存、高可用、数据分析 等不同场景：
- library/redis Docker 镜像说明（官方标准版本，适合通用场景）
- redis/redis-stack-server Docker 镜像说明（内置 Redis Stack，适合模块化场景）
- redislabs/redis Docker 镜像说明（官方实验与扩展版本）
- bitnami/redis Docker 镜像说明（企业级配置，适合生产环境）
- arm64v8/redis Docker 镜像说明（Redis 数据库，ARM64 架构版本）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull mcp/redis:<标签>
更多 redis 镜像推荐
library/redis
Docker 官方镜像
Redis 官方 Docker 镜像，提供开箱即用的高性能键值数据库服务，适合作为缓存、会话存储、消息队列和排行榜等场景的基础组件，支持持久化与多架构部署，适合本地开发与生产环境按需扩展使用。
1.4万 次收藏10亿+ 次下载
8 天前更新
redis/redis-stack-server
Redis 官方镜像
redis-stack-server是一款用于安装Redis服务器的工具，它在标准Redis服务器的基础上，集成了多种额外的数据库功能，包括对JSON数据类型的原生支持、高效的全文搜索能力、时间序列数据的专门管理机制以及概率数据结构（如布隆过滤器）等，这些扩展功能显著增强了Redis的数据处理多样性和应用灵活性，使其能够更好地满足实时数据分析、内容检索、多模型数据存储等复杂场景的需求。
102 次收藏1000万+ 次下载
5 个月前更新
redis/redis-stack
Redis 官方镜像
Redis Stack是一个集成方案，它安装Redis服务器并赋予其额外的数据库功能，如搜索、JSON数据处理、时间序列管理等，同时包含RedisInsight这一可视化管理工具，帮助用户便捷部署、监控和管理Redis数据库，有效提升开发与运维效率。
160 次收藏1000万+ 次下载
5 个月前更新
redis/redisinsight
Redis 官方镜像
Redis Insight 是 Redis 官方推出的最佳图形用户界面（GUI）工具，它集数据结构可视化浏览与编辑、实时性能监控、集群管理、问题诊断及开发调试等功能于一体，能够帮助开发者和管理员更高效地操作与维护 Redis 数据库，凭借官方出品的可靠性和专业性，成为 Redis 生态中简化日常管理、提升工作效率的不可或缺的利器。
51 次收藏100万+ 次下载
8 天前更新
redislabs/redis
redislabs
Redis Labs提供的集群化内存数据库引擎，完全兼容开源Redis，具备企业级特性，支持高性能、零停机线性扩展和高可用性，适用于分布式应用场景。
45 次收藏1亿+ 次下载
14 天前更新
redis/rdi-operator
Redis 官方镜像
暂无描述
1万+ 次下载
8 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"