Redis MCP 安装与配置指南

 更新时间:2025年07月25日 16:30:55   作者:Hello.Reader  
本文将详细介绍如何安装和配置 Redis MCP,包括快速启动、源码安装、Docker 安装、以及相关的配置参数和环境变量设置,感兴趣的朋友一起看看吧

一、Redis MCP 简介

Redis MCP (Managed Control Plane) 是一个独立于 Redis 服务运行的管理控制平台,用户可通过该平台快速高效地管理和配置 Redis 实例。Redis MCP 可配合开源 Redis 或 Redis Cloud 使用。

二、安装 Redis MCP 服务

Redis MCP 提供多种安装方式,以下逐一介绍:

2.1 快速启动(推荐)

推荐使用官方提供的工具 uvx 快速启动 Redis MCP:

# 使用默认Redis连接
uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server --url redis://localhost:6379/0

SSL 连接:

uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server \
  --url "rediss://<USERNAME>:<PASSWORD>@<HOST>:<PORT>?ssl_cert_reqs=required&ssl_ca_certs=<PATH_TO_CERT>"

或使用单独参数:

uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server \
  --host localhost \
  --port 6379 \
  --password mypassword

查看更多帮助:

uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server --help

2.2 从源码安装

如果需要对 Redis MCP 进行二次开发或深入研究,可以从源码进行安装。

克隆仓库:

git clone https://github.com/redis/mcp-redis.git
cd mcp-redis

初始化 Python 环境(需安装 uv 工具):

uv venv
source .venv/bin/activate
uv sync

运行服务:

# 命令行方式启动(查看帮助)
uv run redis-mcp-server --help
# 直接运行主程序(通过环境变量配置)
uv run src/main.py

2.3 使用 Docker 安装

使用官方镜像启动:

docker run -d --name redis-mcp-server mcp/redis

或从源码构建 Docker 镜像:

git clone https://github.com/redis/mcp-redis.git
cd mcp-redis
docker build -t mcp-redis .
docker run -d --name redis-mcp-server mcp-redis

三、Redis MCP 配置方法

Redis MCP 默认连接到本地主机的 Redis 服务(127.0.0.1:6379,无密码)。如需自定义配置,可通过环境变量或命令行参数实现。

3.1 使用环境变量配置

环境变量配置方法:

export REDIS_HOST="my.redis.host"
export REDIS_PORT=6379
export REDIS_PWD="your_password"
export REDIS_SSL=true

或使用项目目录下的 .env 文件:

REDIS_HOST=my.redis.host
REDIS_PORT=6379
REDIS_USERNAME=myuser
REDIS_PWD=mypassword
REDIS_SSL=true

环境变量完整列表:

名称说明默认值
REDIS_HOSTRedis IP 或主机名127.0.0.1
REDIS_PORTRedis 端口6379
REDIS_DBRedis 数据库索引0
REDIS_USERNAMERedis 用户名default
REDIS_PWDRedis 密码
REDIS_SSL启用 SSL/TLSFalse
REDIS_CA_PATHCA 证书路径None
REDIS_SSL_KEYFILE客户端 SSL 私钥路径None
REDIS_SSL_CERTFILE客户端 SSL 证书路径None
REDIS_CERT_REQS客户端是否验证服务器证书required
REDIS_CA_CERTS信任的 CA 证书路径None
REDIS_CLUSTER_MODE启用 Redis Cluster 模式False
MCP_TRANSPORTstdio 或 sse 传输模式stdio

3.2 使用命令行参数配置

命令行参数配置示例:

基本连接:

uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server \
  --host localhost \
  --port 6379 \
  --password mypassword

URI 连接方式(推荐):

uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server \
  --url redis://user:pass@localhost:6379/0

SSL 连接方式:

uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server \
  --url rediss://user:pass@redis.example.com:6379/0

四、Redis Cloud MCP 安装方法(进阶)

Redis Cloud MCP 提供额外的功能,如订阅管理和账单详情管理。

4.1 源码安装 Redis Cloud MCP

git clone https://github.com/redis/mcp-redis-cloud.git
cd mcp-redis-cloud
npm run build

启动后即可使用 Redis Cloud 专属功能:

  • 创建 AWS Redis 数据库
  • 查看当前订阅
  • 推荐合适的数据库配置等

4.2 Docker 安装 Redis Cloud MCP

构建并启动 Docker 容器:

git clone https://github.com/redis/mcp-redis-cloud.git
cd mcp-redis-cloud
docker build -t mcp/redis-cloud .
docker run -d --name redis-cloud-mcp mcp/redis-cloud

五、下一步操作

Redis MCP 服务安装完成后,需要客户端应用连接并使用其服务。具体客户端配置方法,请参考 Redis MCP 客户端配置文档。

六、总结

Redis MCP 提供便捷、高效的 Redis 管理功能,通过本文的步骤,用户可快速完成 Redis MCP 服务的安装和基本配置,从而轻松管理和控制 Redis 服务,提高运维效率。

到此这篇关于Redis MCP 安装与配置指南的文章就介绍到这了,更多相关Redis MCP 安装配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Redisson实现分布式锁、锁续约的案例

    Redisson实现分布式锁、锁续约的案例

    这篇文章主要介绍了Redisson如何实现分布式锁、锁续约,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-03-03
  • 利用Redis如何实现自动补全功能

    利用Redis如何实现自动补全功能

    这篇文章主要给大家介绍了关于如何利用Redis如何实现自动补全功能的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用Redis具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-09-09
  • SpringBoot整合Mybatis-plus和Redis实现投票功能

    SpringBoot整合Mybatis-plus和Redis实现投票功能

    投票功能是一个非常常见的Web应用场景,这篇文章将为大家介绍一下如何将Redis和Mybatis-plus整合到SpringBoot中,实现投票功能,感兴趣的可以了解一下
    2023-05-05
  • 一文解决Redis后台持久化失败的问题:内存不足导致fork失败

    一文解决Redis后台持久化失败的问题:内存不足导致fork失败

    Redis作为一个内存数据库,在执行后台持久化(例如 BGSAVE 命令时)需要fork一个子进程来生成数据库快照(RDB 文件),在生产环境中,有时你可能会在Redis日志中遇到持久化失败的问题,本文将详细介绍该问题的原因以及如何通过调整内核和Redis配置来解决此问题
    2025-07-07
  • Redis Template实现分布式锁的实例代码

    Redis Template实现分布式锁的实例代码

    使用Redis的SETNX命令获取分布式锁的步骤,接下来通过本文给大家介绍Redis Template实现分布式锁的实例代码,代码简单易懂,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2018-09-09
  • redis的主从配置方法详解

    redis的主从配置方法详解

    今天为大家介绍下linux系统下redis的主从配置方法,Linux系统下的redis的主从配置方法非常简单下面是具体的操作步骤
    2018-09-09
  • 使用AOP+redis+lua做方法限流的实现

    使用AOP+redis+lua做方法限流的实现

    本文主要介绍了使用AOP+redis+lua做方法限流的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-04-04
  • Redis实现库存扣减的示例代码

    Redis实现库存扣减的示例代码

    在日常开发中有很多地方都有类似扣减库存的操作,本文主要介绍了Redis实现库存扣减的示例代码,具有一定的参考价值,感兴趣的可以了解一下
    2023-07-07
  • redis单节点安装与配置方式

    redis单节点安装与配置方式

    这篇文章主要介绍了redis单节点安装与配置方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-01-01
  • 详解利用redis + lua解决抢红包高并发的问题

    详解利用redis + lua解决抢红包高并发的问题

    本篇文章主要介绍了利用redis + lua解决抢红包高并发的问题 ,详细的讲诉了需求分析和方案,有兴趣的可以了解一下。
    2016-11-11

最新评论