Kiro 中配置 Redis MCP Server 完整指南
Kiro 中配置 Redis MCP Server 完整指南
一、什么是 MCP
MCP（Model Context Protocol）是一种让 AI 代理与外部工具通信的标准协议。在 Kiro 中配置 MCP Server 后，AI 可以直接操作数据库、Redis、Git 等外部系统，无需你手动复制粘贴数据。
注：
博客：
https://blog.csdn.net/badao_liumang_qizhi
二、配置文件位置
| 作用域 | 路径 |
|---|---|
| 工作区级别 | .kiro/settings/mcp.json |
| 用户全局级别 | ~/.kiro/settings/mcp.json |
多个工作区文件夹时，后面的 workspace 配置会覆盖前面的。
三、Redis MCP Server 方案选择
方案一：Node.js 版（推荐）
使用@modelcontextprotocol/server-redis，基于 ioredis 库，兼容 Redis 5.x 及以上版本。
{"mcpServers":{"redis":{"command":"npx","args":["-y","@modelcontextprotocol/server-redis","redis://:密码@地址:端口/数据库编号"],"env":{},"disabled":false,"autoApprove":[]}}}连接字符串格式：
- 有密码：
redis://:your_password@127.0.0.1:6379/0 - 无密码：
redis://127.0.0.1:6379/0
前置要求：已安装 Node.js（npx 随 Node.js 自带）
方案二：Python 版（uvx）
使用mcp-server-redis，基于 Python redis 库，要求 Redis 6.0+（因为使用 RESP3 协议）。
{"mcpServers":{"redis":{"command":"uvx","args":["mcp-server-redis"],"env":{"REDIS_HOST":"127.0.0.1","REDIS_PORT":"6379","REDIS_DB":"0","REDIS_PASSWORD":"your_password","UV_INDEX_URL":"https://mirrors.aliyun.com/pypi/simple/"},"disabled":false,"autoApprove":[]}}}前置要求：已安装 uv（pip install uv或参考 https://docs.astral.sh/uv/getting-started/installation/）
四、配置字段详解
| 字段 | 说明 |
|---|---|
command | 启动命令，npx或uvx |
args | 命令参数数组，-y表示自动确认安装 |
env | 环境变量，传递连接信息或镜像源配置 |
disabled | 是否禁用该 MCP Server，设为true可临时关闭 |
autoApprove | 自动批准的工具列表，空数组表示每次都需确认 |
五、可用的 Redis 工具
连接成功后，以下工具可直接使用：
| 工具 | 功能 | 示例用法 |
|---|---|---|
set | 设置 key-value | 设置缓存、写入配置 |
get | 获取 key 的值 | 查看缓存内容 |
delete | 删除 key | 清除过期缓存 |
list | 按 pattern 列出所有 key | 用*查看全部，用user:*模糊匹配 |
六、常见问题排查
问题 1：PyPI 下载超时
日志特征：
Request failed after 3 retries in 51.0s Caused by: Failed to fetch: `https://pypi.org/simple/mcp-server-redis/`原因：国内网络访问 PyPI 官方源不稳定。
解决：在env中添加国内镜像源：
"UV_INDEX_URL":"https://mirrors.aliyun.com/pypi/simple/"备选镜像源：
- 阿里云：
https://mirrors.aliyun.com/pypi/simple/ - 清华：
https://pypi.tuna.tsinghua.edu.cn/simple - 中科大：
https://pypi.mirrors.ustc.edu.cn/simple/
问题 2：镜像源返回 403 Forbidden
日志特征：
An index (https://pypi.tuna.tsinghua.edu.cn/simple) returned a 403 Forbidden error原因：镜像源临时限流或 URL 缺少尾部斜杠。
解决：换一个镜像源，注意 URL 末尾加/。
问题 3：unknown command ‘HELLO’
日志特征：
Error executing tool: unknown command 'HELLO'原因：Redis 版本低于 6.0，不支持 RESP3 协议的HELLO握手命令。Python 版mcp-server-redis默认使用 RESP3。
解决：切换到 Node.js 版（@modelcontextprotocol/server-redis），它基于 ioredis，兼容旧版 Redis。
问题 4：缺少环境变量
日志特征：
ValidationError: 4 validation errors for RedisSettings REDIS_HOST Field required REDIS_PORT Field required原因：Python 版包通过环境变量读取配置，--url命令行参数不被支持。
解决：在env中配置REDIS_HOST、REDIS_PORT、REDIS_DB、REDIS_PASSWORD四个必填项。
问题 5：npx 下载慢
解决：配置 npm 镜像源：
"env":{"npm_config_registry":"https://registry.npmmirror.com"}七、完整配置示例
{"mcpServers":{"redis":{"command":"npx","args":["-y","@modelcontextprotocol/server-redis","redis://:123456@127.0.0.1:6379/0"],"env":{},"disabled":false,"autoApprove":[]}}}八、验证连接
配置保存后 Kiro 会自动重连。成功后可以让 AI 执行：
- “列出所有 Redis key” → 调用
list工具 - “获取某个 key 的值” → 调用
get工具 - “写入一个测试 key” → 调用
set工具
如果 MCP Logs 面板显示MCP connection closed错误，参考上面的常见问题逐一排查。