redis/mcp-redisPlease refer to the latest official releases for information GitHub Homepage

官方Redis MCP服务器，为智能代理应用提供自然语言接口，高效管理和搜索Redis数据

MITPython 88redis Last Updated: 2025-06-08

Redis MCP服务器 - 项目详细介绍

项目概述

Redis MCP服务器是Redis官方开发的模型内容协议(Model Content Protocol)服务器，为AI代理应用提供自然语言接口，使其能够高效地管理和搜索Redis中的数据。该项目与MCP客户端无缝集成，支持AI驱动的工作流程与Redis中的结构化和非结构化数据进行交互。

项目地址: https://github.com/redis/mcp-redis

核心特性

🤖 自然语言查询

支持AI代理使用自然语言查询和更新Redis数据
可以处理诸如"将整个对话存储在流中"、"缓存此项目"、"存储带有过期时间的会话"等自然语言指令

🔗 无缝MCP集成

与任何MCP客户端兼容，实现流畅的通信
支持stdio和SSE两种传输协议

📊 全面的Redis支持

支持Redis的所有主要数据结构：

字符串(String): 存储简单配置值、会话数据或缓存响应
哈希(Hash): 存储字段-值对，支持向量嵌入存储
列表(List): 队列、消息代理或维护最近操作列表
集合(Set): 跟踪唯一值，支持集合运算
有序集合(Sorted Set): 排行榜、优先队列、基于时间的分析
发布/订阅(Pub/Sub): 实时通知、聊天应用、分发更新
流(Streams): 事件溯源、活动源、传感器数据记录
JSON: 复杂嵌套数据结构、文档数据库

🔍 搜索与过滤

支持高效的数据检索和搜索
向量索引管理和向量搜索功能
查询引擎工具

⚡ 高性能与轻量级

专为高性能数据操作设计
可扩展的架构

安装与配置

环境要求

Python 3.13+
uv包管理器
Redis服务器

安装步骤

# 克隆仓库
git clone https://github.com/redis/mcp-redis.git
cd mcp-redis

# 使用uv安装依赖
uv venv
source .venv/bin/activate
uv sync

环境变量配置

变量名	描述	默认值
`REDIS_HOST`	Redis IP或主机名	"127.0.0.1"
`REDIS_PORT`	Redis端口	6379
`REDIS_USERNAME`	数据库用户名	"default"
`REDIS_PWD`	数据库密码	""
`REDIS_SSL`	启用/禁用SSL/TLS	False
`REDIS_CA_PATH`	CA证书路径	None
`REDIS_SSL_KEYFILE`	客户端私钥文件	None
`REDIS_SSL_CERTFILE`	客户端证书文件	None
`REDIS_CERT_REQS`	是否验证服务器证书	"required"
`REDIS_CA_CERTS`	受信任CA证书文件路径	None
`REDIS_CLUSTER_MODE`	启用Redis集群模式	False
`MCP_TRANSPORT`	传输协议(stdio/sse)	stdio

部署方式

1. 本地进程方式 (默认)

# 使用stdio传输
uv run src/main.py

2. 网络服务方式

# 设置SSE传输
export MCP_TRANSPORT="sse"
uv run src/main.py

# 测试服务器
curl -i http://127.0.0.1:8000/sse

3. Docker部署

# 构建镜像
docker build -t mcp-redis .

# 运行容器
docker run --rm --name redis-mcp-server -i \
  -e REDIS_HOST=<redis_hostname> \
  -e REDIS_PORT=<redis_port> \
  -e REDIS_USERNAME=<redis_username> \
  -e REDIS_PWD=<redis_password> \
  mcp-redis

集成方式

Claude Desktop集成

编辑claude_desktop_config.json文件：

{
  "mcpServers": {
    "redis": {
      "command": "<uv命令完整路径>",
      "args": [
        "--directory",
        "<MCP服务器目录>",
        "run",
        "src/main.py"
      ],
      "env": {
        "REDIS_HOST": "<Redis主机名>",
        "REDIS_PORT": "<Redis端口>",
        "REDIS_PWD": "<Redis密码>",
        "REDIS_SSL": true,
        "REDIS_CA_PATH": "<CA证书路径>"
      }
    }
  }
}

VS Code集成

启用代理模式并配置mcp.json：

{
  "servers": {
    "redis": {
      "type": "stdio",
      "command": "<uv命令完整路径>",
      "args": [
        "--directory",
        "<MCP服务器目录>",
        "run",
        "src/main.py"
      ],
      "env": {
        "REDIS_HOST": "<Redis主机名>",
        "REDIS_PORT": "<Redis端口>",
        "REDIS_USERNAME": "<Redis用户名>",
        "REDIS_PWD": "<Redis密码>"
      }
    }
  }
}

OpenAI代理SDK集成

# 安装SDK
pip install openai-agents

# 配置API密钥
export OPENAI_API_KEY="<openai_token>"

# 运行应用
python3.13 redis_assistant.py

自动化部署 (Smithery)

# 使用Smithery自动配置Claude Desktop
npx -y @smithery/cli install @redis/mcp-redis --client claude

应用场景

🤖 AI助手

让大语言模型能够获取、存储和处理Redis中的数据
实现智能数据管理和查询

💬 聊天机器人和虚拟代理

检索会话数据
管理消息队列
个性化响应

📈 数据搜索与分析

实时洞察查询
快速数据查找
向量相似性搜索

🔄 事件处理

使用Redis流管理事件流
实时数据处理
事件溯源

调试和故障排除

MCP检查器

# 可视化调试
npx @modelcontextprotocol/inspector uv run src/main.py

日志监控

# 监控Claude日志
tail -f ~/Library/Logs/Claude/mcp-server-redis.log

OpenAI仪表板

可以通过OpenAI仪表板进行代理工作流故障排除。

开发与贡献

贡献流程

Fork仓库
创建新分支 (feature-branch)
提交更改
推送到分支并提交PR

技术栈

语言: Python 3.13+
包管理: uv
协议: MCP (Model Content Protocol)
数据库: Redis
容器化: Docker

许可证与支持

许可证: MIT License
技术支持: 通过GitHub Issues获取帮助

总结

Redis MCP服务器是一个强大的工具，它桥接了AI代理和Redis数据库之间的gap，通过自然语言接口使AI应用能够更智能地管理和查询数据。无论是构建智能助手、聊天机器人还是进行实时数据分析，这个项目都提供了一个可靠、高效的解决方案。

其模块化的设计、丰富的Redis数据结构支持以及多种部署方式，使其适用于从小型项目到企业级应用的各种场景。通过与Claude、VS Code、OpenAI等主流平台的集成，开发者可以轻松地将Redis的强大功能融入到他们的AI驱动应用中。