适合谁
- 需要与 Redis 交互的 AI 代理
- 需要自然语言管理 Redis 数据的应用
- 使用 MCP 客户端（如 Claude Desktop）的开发流程
M
60FMRS · C
这是 Redis 官方维护的 MCP 服务器，功能全面，支持多种数据结构和向量搜索，集成简单，但有数据误操作和凭据泄露风险。
Redis MCP Server 是 Redis 官方的 MCP 服务器，为智能体应用提供自然语言接口，用于高效地管理和搜索 Redis 中的数据。它支持 Redis 的多种数据结构（字符串、哈希、列表、集合、有序集合、流、JSON），并提供文档搜索和向量搜索工具。可通过 PyPI 或 Docker 安装，支持通过命令行参数或环境变量配置，支持 EntraID 认证。
工具能力
string
设置和获取带过期时间的字符串值。
hash
存储和操作哈希字段，可存储向量嵌入。
list
追加和弹出列表元素，适用于队列或消息代理。
set
添加、移除和列出集合成员，支持集合运算。
sorted set
管理有序集合，适用于排行榜、优先级队列等。
pub/sub
发布消息、创建订阅和读取消息。
streams
添加、读取、删除流数据，管理消费组。
JSON
存储、检索和操作 JSON 文档。
docs
搜索 Redis 文档和最佳实践。
query engine
管理向量索引和执行向量搜索。
server management
获取数据库信息。
安装接入
- 使用 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"
]
}
}
}
选型与风险
不适合谁
- 纯数据管道，无需自然语言层
- 仅需简单 KV 场景且无 MCP 需求
- 对性能要求极高且需直接 Redis 友好的生产系统
所需权限
- 需要 Redis 连接凭据（如 URL、用户名、密码）
- 可以读取、写入和删除 Redis 中的数据
- 可以创建索引和执行搜索
风险与副作用
- 数据误操作风险：AI 可能意外删除或覆盖数据
- 凭据泄露：如果配置不当，Redis 凭据可能暴露
- 资源消耗：大量向量索引可能消耗内存
常见排障
- 检查 Redis 连接是否可访问（默认 localhost:6379）
- 确保凭据正确，特别是密码和 ACL 权限
- 检查日志：通过 `MCP_REDIS_LOG_LEVEL=DEBUG` 环境变量增加日志级别
- 确认 `redis-server` 服务正在运行
使用场景
AI 助手访问 Redis 数据
聊天机器人管理会话数据
实时数据搜索和分析
事件流处理
支持客户端
Claude Desktop完整支持