Redis MCP 安装与配置指南_Redis

一、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_host	redis ip 或主机名	127.0.0.1
redis_port	redis 端口	6379
redis_db	redis 数据库索引	0
redis_username	redis 用户名	default
redis_pwd	redis 密码	空
redis_ssl	启用 ssl/tls	false
redis_ca_path	ca 证书路径	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_transport	stdio 或 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