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 及以上版本。

json 复制代码

{
  "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 协议）。

json 复制代码

{
  "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 中添加国内镜像源：

json 复制代码

"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 镜像源：

json 复制代码

"env": {
  "npm_config_registry": "https://registry.npmmirror.com"
}

七、完整配置示例

json 复制代码

{
  "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 错误，参考上面的常见问题逐一排查。