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

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

相关推荐
Henry-SAP8 小时前
PP的生产调度员(Production Scheduler)的角色与配置
数据库
Flynn Liang10 小时前
HikariCP 连接池不是越大越好:I/O 密集型 Java 服务的数据库容量工程
java·数据库·mysql·高并发·连接池·hikaricp·sql 优化
小乖写代码12 小时前
消息、回执与媒体 · msgstore.db · Messages, Receipts, and Media
数据库·媒体·whatsapp·消息回执
泓度科技13 小时前
接口防暴力破解+短信防刷,低成本安全加固怎么做
redis·安全加固·限流熔断·接口防暴力破解·短信防刷
GeW13 小时前
世界目光聚焦中国:底层技术、Linux、数据库的破局逻辑
linux·数据库
PingCAP14 小时前
平凯数据库 × 圣诺云数:让治理数据实时可用、跨域可信流通
数据库·tidb
利威尔xu14 小时前
PostgreSQL 索引失效 4 类:函数运算让查询全表扫描拖垮性能
开发语言·数据库·postgresql·性能优化·索引优化
PingCAP14 小时前
挚文集团(陌陌、探探)从 MySQL 分库分表到 TiDB 实时统一架构的实践
数据库·tidb
Decay__14 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构
杨凯凡14 小时前
Spring Framework 7 原生重试与并发限制实战:@Retryable、@ConcurrencyLimit 能替代 Resilience4j 吗?
数据库·spring·sqlserver