Redis MCP 安装与配置指南
一、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 服务,提高运维效率。
到此这篇关于Redis MCP 安装与配置指南的文章就介绍到这了,更多相关Redis MCP 安装配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
相关文章
Redis Desktop Manager(Redis可视化工具)安装及使用图文教程
这篇文章主要介绍了Redis Desktop Manager(Redis可视化工具)安装及使用图文教程,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下2023-04-04


最新评论