Redis MCP 安装与配置完整指南_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://:@:?ssl_cert_reqs=required&ssl_ca_certs=\"

或使用单独参数：

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.gitcd mcp-redis

初始化 Python 环境（需安装 uv 工具）：

uv venvsource .venv/bin/activateuv 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.gitcd mcp-redisdocker 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=6379export REDIS_PWD=\"your_password\"export REDIS_SSL=true

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

REDIS_HOST=my.redis.hostREDIS_PORT=6379REDIS_USERNAME=myuserREDIS_PWD=mypasswordREDIS_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.gitcd mcp-redis-cloudnpm run build

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

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

4.2 Docker 安装 Redis Cloud MCP

构建并启动 Docker 容器：

git clone https://github.com/redis/mcp-redis-cloud.gitcd mcp-redis-clouddocker 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 服务，提高运维效率。