一、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

五、下一步操作

Redis MCP 服務安裝完成后，需要客戶端應用連接并使用其服務。具體客戶端配置方法，請參考 Redis MCP 客戶端配置文檔。

六、總結

Redis MCP 提供便捷、高效的 Redis 管理功能，通過本文的步驟，用戶可快速完成 Redis MCP 服務的安裝和基本配置，從而輕松管理和控制 Redis 服務，提高運維效率。