redis/mcp-redis View GitHub Homepage for Latest Official Releases

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

MITPythonmcp-redisredis 286 Last Updated: October 16, 2025

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仪表板进行代理工作流故障排除。

开发与贡献

贡献流程

  1. Fork仓库
  2. 创建新分支 (feature-branch)
  3. 提交更改
  4. 推送到分支并提交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驱动应用中。

所有详细信息，请以官方网站公布为准 (https://github.com/redis/mcp-redis)

Star History Chart