热门搜索:
mcp/redis
提供Redis数据库操作访问能力，支持44种工具，包括键管理、数据结构操作、向量索引创建及相似度搜索等，基于Model Context Protocol (MCP) 实现安全高效的Redis交互。
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Redis MCP Server
用于访问Redis数据库操作。
什么是MCP Server？
MCP信息
| 属性 | 详情 |
|---|---|
| Docker镜像 | https://hub.docker.com/repository/docker/mcp/redis |
| 作者 | https://github.com/redis |
| 代码仓库 | https://github.com/redis/mcp-redis |
镜像构建信息
| 属性 | 详情 |
|---|---|
| Dockerfile | https://github.com/redis/mcp-redis/blob/main/Dockerfile |
| Docker镜像构建者 | Docker Inc. |
| Docker Scout健康评分 | !Docker Scout健康评分 |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/redis --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| 许可证 | MIT License |
可用工具（44种）
| 本服务器提供的工具 | 简短描述 |
|---|---|
client_list | 获取Redis服务器的已连接客户端列表。 |
create_vector_index_hash | 在Redis哈希上使用HNSW创建Redis 8向量相似度索引。 |
dbsize | 获取Redis数据库中存储的键数量 |
delete | 删除Redis键。 |
expire | 为Redis键设置过期时间。 |
get | 获取Redis字符串值。 |
get_index_info | 使用FT.INFO检索特定Redis索引的模式和信息。 |
get_indexed_keys_number | 检索索引所索引的键数量 |
get_indexes | Redis数据库中的索引列表 |
get_vector_from_hash | 从Redis哈希中检索向量并从二进制blob转换回来。 |
hdel | 从Redis哈希中删除字段。 |
hexists | 检查Redis哈希中是否存在字段。 |
hget | 获取Redis哈希中字段的值。 |
hgetall | 获取Redis哈希中的所有字段和值。 |
hset | 在哈希中设置字段，可选设置过期时间。 |
info | 获取Redis服务器信息和统计数据。 |
json_del | 从Redis中删除指定路径的JSON值。 |
json_get | 从Redis中检索指定路径的JSON值。 |
json_set | 在Redis中指定路径设置JSON值，可选设置过期时间。 |
llen | 获取Redis列表的长度。 |
lpop | 从Redis列表中移除并返回第一个元素。 |
lpush | 将值添加到Redis列表左侧，可选设置过期时间。 |
lrange | 获取Redis列表中特定范围内的元素。 |
publish | 向Redis频道发布消息。 |
rename | 将Redis键从旧键名重命名为新键名。 |
rpop | 从Redis列表中移除并返回最后一个元素。 |
rpush | 将值添加到Redis列表右侧，可选设置过期时间。 |
sadd | 向Redis集合添加值，可选设置过期时间。 |
scan_all_keys | 使用多次SCAN迭代扫描并返回所有匹配模式的键。 |
scan_keys | 使用SCAN命令扫描Redis数据库中的键（非阻塞，生产环境安全）。 |
set | 设置Redis字符串值，可选设置过期时间。 |
set_vector_in_hash | 将向量存储为Redis哈希中的字段。 |
smembers | 获取Redis集合的所有成员。 |
srem | 从Redis集合中移除值。 |
subscribe | 订阅Redis频道。 |
type | 返回键存储的值类型的字符串表示。 |
unsubscribe | 取消订阅Redis频道。 |
vector_search_hash | 使用Redis 8或更高版本对存储在哈希数据结构中的向量执行KNN向量相似度搜索。 |
xadd | 向Redis流添加条目，可选设置过期时间。 |
xdel | 从Redis流中删除条目。 |
xrange | 从Redis流中读取条目。 |
zadd | 向Redis有序集合添加成员，可选设置过期时间。 |
zrange | 从Redis有序集合中检索成员范围。 |
zrem | 从Redis有序集合中移除成员。 |
工具详情
工具：**client_list**获取Redis服务器的已连接客户端列表。
工具：**create_vector_index_hash**在Redis哈希上使用HNSW创建Redis 8向量相似度索引。
此函数使用HNSW算法和float32向量嵌入设置Redis索引，用于近似最近邻（ANN）搜索。
| 参数 | 类型 | 描述 |
|---|---|---|
dim | integer 可选 | 向量字段下存储的向量维度。 |
distance_metric | string 可选 | 使用的距离函数（例如：'COSINE'、'L2'、'IP'）。 |
index_name | string 可选 | 要创建的Redis索引名称。除非特别需要，否则使用默认索引名称。 |
prefix | string 可选 | 用于标识要索引的文档的键前缀（例如：'doc:'）。除非特别需要，否则使用默认前缀。 |
vector_field | string 可选 | 要索引用于相似度搜索的向量字段名称。除非特别需要，否则使用默认字段名称。 |
工具：**dbsize**获取Redis数据库中存储的键数量。
工具：**delete**删除Redis键。
| 参数 | 类型 | 描述 |
|---|---|---|
key | string |
工具：**expire**为Redis键设置过期时间。
| 参数 | 类型 | 描述 |
|---|---|---|
expire_seconds | integer | 键过期的时间（秒）。 |
name | string | Redis键名。 |
工具：**get**获取Redis字符串值。
| 参数 | 类型 | 描述 |
|---|---|---|
key | string |
工具：**get_index_info**使用FT.INFO检索特定Redis索引的模式和信息。
| 参数 | 类型 | 描述 |
|---|---|---|
index_name | string |
工具：**get_indexed_keys_number**检索索引所索引的键数量。
| 参数 | 类型 | 描述 |
|---|---|---|
index_name | string |
工具：**get_indexes**Redis数据库中的索引列表。
返回： str: 包含索引列表的JSON字符串或错误消息。
工具：**get_vector_from_hash**从Redis哈希中检索向量并从二进制blob转换回来。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | Redis哈希键名。 |
vector_field | string 可选 | 哈希中的字段名。除非特别需要，否则使用默认字段名称。 |
工具：**hdel**从Redis哈希中删除字段。
| 参数 | 类型 | 描述 |
|---|---|---|
key | string | 哈希中的字段名。 |
name | string | Redis哈希键名。 |
工具：**hexists**检查Redis哈希中是否存在字段。
| 参数 | 类型 | 描述 |
|---|---|---|
key | string | 哈希中的字段名。 |
name | string | Redis哈希键名。 |
工具：**hget**获取Redis哈希中字段的值。
| 参数 | 类型 | 描述 |
|---|---|---|
key | string | 哈希中的字段名。 |
name | string | Redis哈希键名。 |
工具：**hgetall**获取Redis哈希中的所有字段和值。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | Redis哈希键名。 |
工具：**hset**在哈希中设置字段，可选设置过期时间。
| 参数 | 类型 | 描述 |
|---|---|---|
key | string | 哈希中的字段名。 |
name | string | Redis哈希键名。 |
value | string | 要设置的值。 |
expire_seconds | string 可选 | 可选；键过期的时间（秒）。 |
工具：**info**获取Redis服务器信息和统计数据。
| 参数 | 类型 | 描述 |
|---|---|---|
section | string 可选 | info命令的部分（default、memory、cpu等）。 |
工具：**json_del**从Redis中删除指定路径的JSON值。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | 存储JSON文档的Redis键名。 |
path | string 可选 | 要删除的JSON路径（默认：根路径'$'）。 |
工具：**json_get**从Redis中检索指定路径的JSON值。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | 存储JSON文档的Redis键名。 |
path | string 可选 | 要检索的JSON路径（默认：根路径'$'）。 |
工具：**json_set**在Redis中指定路径设置JSON值，可选设置过期时间。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | 存储JSON文档的Redis键名。 |
path | string | 设置值的JSON路径。 |
value | string | 要存储的JSON值。 |
expire_seconds | string 可选 | 可选；键过期的时间（秒）。 |
工具：**llen**获取Redis列表的长度。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string |
工具：**lpop**从Redis列表中移除并返回第一个元素。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string |
工具：**lpush**将值添加到Redis列表左侧，可选设置过期时间。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | |
value | string | |
expire | string 可选 |
工具：**lrange**获取Redis列表中特定范围内的元素。
返回： str: 包含元素列表的JSON字符串或错误消息。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | |
start | integer | |
stop | integer |
工具：**publish**向Redis频道发布消息。
| 参数 | 类型 | 描述 |
|---|---|---|
channel | string | 要发布的Redis频道。 |
message | string | 要发送的消息。 |
工具：**rename**将Redis键从旧键名重命名为新键名。
| 参数 | 类型 | 描述 |
|---|---|---|
new_key | string | |
old_key | string |
工具：**rpop**从Redis列表中移除并返回最后一个元素。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string |
工具：**rpush**将值添加到Redis列表右侧，可选设置过期时间。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | |
value | string | |
expire | string 可选 |
工具：**sadd**向Redis集合添加值，可选设置过期时间。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | Redis集合键名。 |
value | string | 要添加到集合的值。 |
expire_seconds | string 可选 | 可选；集合过期的时间（秒）。 |
工具：**scan_all_keys**使用多次SCAN迭代扫描并返回所有匹配模式的键。
此函数自动处理SCAN游标迭代以收集所有匹配键。对于大型数据库，它比KEYS *更安全，但仍会将所有结果收集到内存中。
⚠️ 警告：对于非常大的数据集（数百万个键），这可能会消耗大量内存。对于大规模操作，请考虑使用scan_keys()进行手动迭代。
| 参数 | 类型 | 描述 |
|---|---|---|
batch_size | integer 可选 | 每次迭代扫描的键数（默认100）。 |
pattern | string 可选 | 匹配键的模式（默认"*"匹配所有键）。 |
工具：**scan_keys**使用SCAN命令扫描Redis数据库中的键（非阻塞，生产环境安全）。
⚠️ 重要：这返回一次迭代的部分结果。使用scan_all_keys()获取所有匹配键，或使用返回的游标多次调用此函数，直到游标变为0。
SCAN命令以小批量迭代键空间，可安全用于大型数据库而不会阻塞其他操作。
| 参数 | 类型 | 描述 |
|---|---|---|
count | integer 可选 | 每次迭代返回的键数提示（默认100）。 |
cursor | integer 可选 | 开始扫描的游标位置（0表示从开始）。 |
pattern | string 可选 | 匹配键的模式（默认"*"匹配所有键）。 |
工具：**set**设置Redis字符串值，可选设置过期时间。
| 参数 | 类型 | 描述 |
|---|---|---|
key | string | |
value | string | |
expiration | string 可选 |
工具：**set_vector_in_hash**将向量存储为Redis哈希中的字段。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | Redis哈希键名。 |
vector | array | 要存储在哈希中的向量（数字列表）。 |
vector_field | string 可选 | 哈希中的字段名。除非特别需要，否则使用默认字段名称。 |
工具：**smembers**获取Redis集合的所有成员。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | Redis集合键名。 |
工具：**srem**从Redis集合中移除值。
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | Redis集合键名。 |
value | string | 要从集合中移除的值。 |
工具：**subscribe**订阅Redis频道。
| 参数 | 类型 | 描述 |
|---|---|---|
channel | string | 要订阅的Redis频道。 |
工具：**type**返回键存储的值类型的字符串表示。
| 参数 | 类型 | 描述 |
|---|---|---|
key | string |
工具：**unsubscribe**取消订阅Redis频道。
| 参数 | 类型 | 描述 |
|---|---|---|
channel | string | 要取消订阅的Redis频道。 |
工具：**vector_search_hash**使用Redis 8或更高版本对存储在哈希数据结构中的向量执行KNN向量相似度搜索。
| 参数 | 类型 | 描述 |
|---|---|---|
query_vector | array | 用作查询向量的浮点数列表。 |
index_name | string 可选 | Redis索引名称。除非特别指定，否则使用默认索引名称。 |
k | integer 可选 | 要返回的最近邻数量。 |
return_fields | string 可选 | 要返回的字段列表（可选）。 |
vector_field | string 可选 | 已索引的向量字段名称。除非特别需要，否则使用默认字段名称。 |
工具：**xadd**向Redis流添加条目，可选设置过期时间。
| 参数 | 类型 | 描述 |
|---|---|---|
fields | object | |
key | string | |
expiration | string 可选 |
工具：**xdel**从Redis流中删除条目。
| 参数 | 类型 | 描述 |
|---|---|---|
entry_id | string | |
key | string |
工具：**xrange**从Redis流中读取条目。
| 参数 | 类型 | 描述 |
|---|---|---|
key | string | |
count | integer 可选 |
工具：**zadd**向Redis
更多相关 Docker 镜像与资源
以下是 mcp/redis 相关的常用 Docker 镜像，适用于 缓存、高可用、数据分析 等不同场景：
- library/redis Docker 镜像说明（官方标准版本，适合通用场景）
- redis/redis-stack-server Docker 镜像说明（内置 Redis Stack，适合模块化场景）
- redislabs/redis Docker 镜像说明（官方实验与扩展版本）
- bitnami/redis Docker 镜像说明（企业级配置，适合生产环境）
- bitnami/redis-cluster Docker 镜像说明（Redis 集群模式，Bitnami 企业级配置）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull mcp/redis:<标签>
更多 redis 镜像推荐
library/redis
Docker 官方镜像
Redis 官方 Docker 镜像，提供开箱即用的高性能键值数据库服务，适合作为缓存、会话存储、消息队列和排行榜等场景的基础组件，支持持久化与多架构部署，适合本地开发与生产环境按需扩展使用。
1.4万 次收藏10亿+ 次下载
6 天前更新
redis/redis-stack-server
Redis 官方镜像
redis-stack-server是一款用于安装Redis服务器的工具，它在标准Redis服务器的基础上，集成了多种额外的数据库功能，包括对JSON数据类型的原生支持、高效的全文搜索能力、时间序列数据的专门管理机制以及概率数据结构（如布隆过滤器）等，这些扩展功能显著增强了Redis的数据处理多样性和应用灵活性，使其能够更好地满足实时数据分析、内容检索、多模型数据存储等复杂场景的需求。
102 次收藏1000万+ 次下载
7 个月前更新
redis/redis-stack
Redis 官方镜像
Redis Stack是一个集成方案，它安装Redis服务器并赋予其额外的数据库功能，如搜索、JSON数据处理、时间序列管理等，同时包含RedisInsight这一可视化管理工具，帮助用户便捷部署、监控和管理Redis数据库，有效提升开发与运维效率。
160 次收藏1000万+ 次下载
7 个月前更新
redis/redisinsight
Redis 官方镜像
Redis Insight 是 Redis 官方推出的最佳图形用户界面（GUI）工具，它集数据结构可视化浏览与编辑、实时性能监控、集群管理、问题诊断及开发调试等功能于一体，能够帮助开发者和管理员更高效地操作与维护 Redis 数据库，凭借官方出品的可靠性和专业性，成为 Redis 生态中简化日常管理、提升工作效率的不可或缺的利器。
51 次收藏100万+ 次下载
1 个月前更新
redislabs/redis
redislabs
Redis Labs提供的集群化内存数据库引擎，完全兼容开源Redis，具备企业级特性，支持高性能、零停机线性扩展和高可用性，适用于分布式应用场景。
46 次收藏1亿+ 次下载
24 天前更新
redis/rdi-operator
Redis 官方镜像
暂无描述
1万+ 次下载
5 天前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"