← 返回目录

MCP redis

官方

用于智能体应用管理和搜索 Redis 数据的自然语言接口。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 17 / 58
Stars: ★ 634 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.14+ · Docker
凭据: 无需凭据
许可证: MIT
最近提交: 2 天前
工具数: 11

60FMRS · C

这是 Redis 官方维护的 MCP 服务器，功能全面，支持多种数据结构和向量搜索，集成简单，但有数据误操作和凭据泄露风险。

最强项 · 文档质量 17/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

9/20

维护活跃度

14/20

文档质量

17/20

安装易用性

14/20

查看各项评分依据

可靠性 6/20: 仅提供了 README 和 server manifest，没有源代码、CI 工作流或已提交的测试。README 声称支持 stdio 传输并提供了多类工具，但静态文件无法验证启动、MCP 握手或工具行为。由于缺少可复现的执行证据，可靠性分数被压低。
安全与权限 9/20: 未发现恶意代码、真实密钥或隐蔽数据外传等红线问题。但配置示例允许在命令行中传递密码，可能通过进程列表泄露；默认权限看起来是广泛的读写删除。文档提供了 ACL 最小权限建议，但没有证据表明危险删除操作有内置确认机制或完整的数据流披露。
维护活跃度 14/20: 仓库属于 Redis 官方组织，使用 MIT 许可证，未被归档，并且有 PyPI、Docker 发布路径和版本引用，维护状态看起来健康。但提供的材料中没有提交历史、问题响应记录、依赖更新日志或安全响应渠道，因此不能给满分。
文档质量 17/20: 文档覆盖了安装、连接参数、环境变量、EntraID 认证、日志以及多个客户端（Claude Desktop、VS Code、OpenAI Agents SDK 等）的配置示例，结构清晰。扣分点在于缺少各工具参数的详细 schema，未明确披露成本或速率限制，故障排查内容也较有限。
安装易用性 14/20: 提供了 PyPI/uvx、GitHub、Docker 和开发环境多种安装方式，并有 Claude Desktop、VS Code 等主流客户端的可直接复制配置示例，步骤明确。但静态校准要求在没有真实 CI 和测试文件时设置分数不超过 15，且需要用户自行准备 Redis 实例和手工配置环境变量，因此给 14 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

需要与 Redis 交互的 AI 代理
需要自然语言管理 Redis 数据的应用
使用 MCP 客户端（如 Claude Desktop）的开发流程

不适合谁

纯数据管道，无需自然语言层
仅需简单 KV 场景且无 MCP 需求
对性能要求极高且需直接 Redis 友好的生产系统

所需权限

需要 Redis 连接凭据（如 URL、用户名、密码）
可以读取、写入和删除 Redis 中的数据
可以创建索引和执行搜索

风险与副作用

数据误操作风险：AI 可能意外删除或覆盖数据
凭据泄露：如果配置不当，Redis 凭据可能暴露
资源消耗：大量向量索引可能消耗内存

安装接入

准备工作

运行环境：Python 3.14+ · Docker

REDIS_PWD 可选密钥 Redis 密码，来自你自己的 Redis 实例 ACL 配置。

REDIS_ENTRAID_CLIENT_SECRET 可选密钥 Azure 服务主体的客户端密钥，来自 Azure 门户。

其他可选配置项（21 个）

REDIS_HOST 可选 Redis 主机名，默认 127.0.0.1，用你自己的 Redis 地址。

REDIS_PORT 可选 Redis 端口，默认 6379。

REDIS_DB 可选逻辑数据库编号，默认 0。

REDIS_USERNAME 可选 Redis 用户名，默认 default。

REDIS_SSL 可选是否启用 SSL/TLS 连接，布尔值。

REDIS_SSL_CA_PATH 可选验证服务器证书的 CA 证书路径。

REDIS_SSL_KEYFILE 可选客户端私钥文件路径，用于双向认证。

REDIS_SSL_CERTFILE 可选客户端证书文件路径。

REDIS_SSL_CERT_REQS 可选是否校验服务器证书，默认 required。

REDIS_SSL_CA_CERTS 可选受信任的 CA 证书文件路径。

REDIS_CLUSTER_MODE 可选是否启用 Redis Cluster 模式。

REDIS_ENTRAID_AUTH_FLOW 可选 Azure EntraID 认证方式：service_principal、managed_identity 或 default_credential。

REDIS_ENTRAID_CLIENT_ID 可选 Azure 服务主体的应用（客户端）ID，来自 Azure 门户。

REDIS_ENTRAID_TENANT_ID 可选 Azure 租户 ID，来自 Azure 门户。

REDIS_ENTRAID_IDENTITY_TYPE 可选托管身份类型：system_assigned 或 user_assigned。

REDIS_ENTRAID_USER_ASSIGNED_CLIENT_ID 可选用户分配托管身份的客户端 ID，来自 Azure 门户。

REDIS_ENTRAID_SCOPES 可选 Default Azure Credential 的 OAuth scope，默认 https://redis.azure.com/.default。

REDIS_ENTRAID_RESOURCE 可选 Azure Redis 资源标识符，默认 https://redis.azure.com/。

REDIS_URL 可选 Redis 连接 URI，例如 redis://user:pass@host:6379/0。

MCP_REDIS_LOG_LEVEL 可选日志级别，如 DEBUG、INFO、WARNING，默认 WARNING。

MCP_DOCS_SEARCH_URL 可选 docs 工具使用的文档搜索 HTTP API 地址。

使用 PyPI 安装：pip install redis-mcp-server。
使用 uvx 运行：uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0。
或在 MCP 客户端配置中导入上述 JSON 配置。

claude_desktop_config.json

{
  "mcpServers": {
    "RedisMCPServer": {
      "command": "uvx",
      "args": [
        "--from", "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url", "redis://localhost:6379/0"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "RedisMCPServer": {
      "command": "uvx",
      "args": [
        "--from",
        "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url",
        "redis://localhost:6379/0"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add RedisMCPServer -- uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 RedisMCPServer 提供的 string、hash、streams、query engine 等工具；也可以直接问“当前 Redis 数据库有多少个 key”来验证连接是否成功。

常见排障

检查 Redis 连接是否可访问（默认 localhost:6379）
确保凭据正确，特别是密码和 ACL 权限
检查日志：通过 `MCP_REDIS_LOG_LEVEL=DEBUG` 环境变量增加日志级别
确认 `redis-server` 服务正在运行

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把这段对话存到一个 Redis stream 里
缓存这个条目，并设置 60 秒过期时间
为这批向量建立索引并执行相似度搜索
查看数据库的内存使用情况

工具能力 11

string 写入

设置和获取带过期时间的字符串值。

hash 写入

存储和操作哈希字段，可存储向量嵌入。

list 写入

追加和弹出列表元素，适用于队列或消息代理。

set 写入

添加、移除和列出集合成员，支持集合运算。

sorted set 写入

管理有序集合，适用于排行榜、优先级队列等。

pub/sub 写入

发布消息、创建订阅和读取消息。

streams 写入

添加、读取、删除流数据，管理消费组。

JSON 写入

存储、检索和操作 JSON 文档。

展开其余 3 个工具

docs 只读

搜索 Redis 文档和最佳实践。

query engine 写入

管理向量索引和执行向量搜索。

server management 只读

获取数据库信息。

使用场景

AI 助手访问 Redis 数据

聊天机器人管理会话数据

实时数据搜索和分析

事件流处理

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Redis MCP Server 是 Redis 官方的 MCP 服务器，为智能体应用提供自然语言接口，用于高效地管理和搜索 Redis 中的数据。它支持 Redis 的多种数据结构（字符串、哈希、列表、集合、有序集合、流、JSON），并提供文档搜索和向量搜索工具。可通过 PyPI 或 Docker 安装，支持通过命令行参数或环境变量配置，支持 EntraID 认证。