Kiro 中配置 Redis MCP Server 完整指南一、什么是 MCPMCPModel 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_password127.0.0.1:6379/0无密码redis://127.0.0.1:6379/0前置要求已安装 Node.jsnpx 随 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:[]}}}前置要求已安装 uvpip install uv或参考 https://docs.astral.sh/uv/getting-started/installation/四、配置字段详解字段说明command启动命令npx或uvxargs命令参数数组-y表示自动确认安装env环境变量传递连接信息或镜像源配置disabled是否禁用该 MCP Server设为true可临时关闭autoApprove自动批准的工具列表空数组表示每次都需确认五、可用的 Redis 工具连接成功后以下工具可直接使用工具功能示例用法set设置 key-value设置缓存、写入配置get获取 key 的值查看缓存内容delete删除 key清除过期缓存list按 pattern 列出所有 key用*查看全部用user:*模糊匹配六、常见问题排查问题 1PyPI 下载超时日志特征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 末尾加/。问题 3unknown 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四个必填项。问题 5npx 下载慢解决配置 npm 镜像源env:{npm_config_registry:https://registry.npmmirror.com}七、完整配置示例{mcpServers:{redis:{command:npx,args:[-y,modelcontextprotocol/server-redis,redis://:123456127.0.0.1:6379/0],env:{},disabled:false,autoApprove:[]}}}八、验证连接配置保存后 Kiro 会自动重连。成功后可以让 AI 执行“列出所有 Redis key” → 调用list工具“获取某个 key 的值” → 调用get工具“写入一个测试 key” → 调用set工具如果 MCP Logs 面板显示MCP connection closed错误参考上面的常见问题逐一排查。