CodeBuddy中配置Redis MCP 连接与排错实战

CodeBuddy中配置Redis MCP 连接与排错实战从零配置 Redis MCP Server到踩遍所有坑最终打通列出数据库全部 key 的完整实录。适用于 Redis 6.0 的本地环境。一、背景与目标在 CodeBuddy或其它支持 MCP 协议的客户端中通过Redis MCP Server让 AI 直接连接本地 Redis 数据库执行keys、get、info等操作。环境信息项目值操作系统WindowsPowerShellRedis本地127.0.0.1:6379密码123456DB0版本 6.0Node.jsv22D:/SoftWare/node22/配置文件C:\Users\admin\.codebuddy\mcp.json注博客https://blog.csdn.net/badao_liumang_qizhi二、最终可用配置先给结论直接用 Node.js 版wenit/redis-mcp-server避开所有协议兼容坑redis-server-local:{command:D:/SoftWare/node22/npx.cmd,args:[-y,wenit/redis-mcp-server],env:{REDIS_HOST:127.0.0.1,REDIS_PORT:6379,REDIS_PASSWORD:123456,REDIS_DB:0},description:Redis本地数据查询服务,disabled:false}配置文件路径C:\Users\admin\.codebuddy\mcp.json的mcpServers节点下。改完后必须重启 MCP 连接禁用再启用或重启 CodeBuddy才会生效。三、完整操作流程步骤 1编辑 MCP 配置文件打开C:\Users\admin\.codebuddy\mcp.json在mcpServers下加入上面「最终可用配置」。步骤 2重启 MCP 连接配置文件改动不会自动重启已运行的 MCP 进程必须手动触发方法一推荐CodeBuddy 设置 → MCP 服务器 →redis-server-local→ 先「禁用」再「启用」。方法二完全退出并重启 CodeBuddy。步骤 3验证连接在对话里直接说「列出所有 key」AI 会调用 MCP 工具。Node.js 版提供的常用工具工具作用keys按 pattern 列出 key{pattern: *}get/set读写字符串info服务器信息ping连通性测试步骤 4成功结果示例Redis 全部 KeyDB 0共 3 个 1. graph:thread:meta:test-002 2. graph:thread:reverse:0310020b-b8e4-401e-9af7-6d21823057d9 3. graph:checkpoint:content:0310020b-b8e4-401e-9af7-6d21823057d9四、踩坑全记录与解决方案按实际发生顺序排列每个坑都是「换配置 → 重启 → 再试」的循环。坑 1pypi.org下载超时现象用 Python 版uvx安装redis-mcp-server时拉包超时。原因默认走 pypi 官方源国内网络不稳。解决在env里加阿里云镜像UV_INDEX_URL:https://mirrors.aliyun.com/pypi/simple坑 2pip install找不到包 / Python 版本过低原因本机 Python 版本太低不满足 MCP 包要求。解决改用uvx自带独立环境而非系统pip。坑 3核心unknown command HELLO现象所有命令dbsize、scan_all_keys报unknown command HELLO。原因HELLO是Redis 6.0 引入的 RESP3 协议握手命令。Python 官方版redis-mcp-server底层redis-py默认发 RESP3 握手而本地 Redis 6.0 不认识直接拒绝。这是已知 Bugredis/mcp-redis Issue #149。无效尝试在 URL 加?protocol2强制 RESP2 —— Python 版不识别这个参数无效。最终解决换成 Node.js 版wenit/redis-mcp-server底层ioredis默认 RESP2不发HELLO。附带修正如果坚持用 URL 形式密码前要有冒号redis://:123456host:port/0否则123456被当成用户名。但根治办法还是换 Node.js 版。坑 4zod缓存损坏ENOENT ... ur.js现象Error: ENOENT: no such file or directory, open C:\Users\admin\AppData\Local\npm-cache\_npx\...\node_modules\zod\v4\locales\ur.js MCP error -32000: Connection closed原因npx缓存里的zod依赖包下载不完整缺文件。解决清掉损坏的 npx 缓存让其重新下载Remove-Item-Recurse-ForceC:\Users\admin\AppData\Local\npm-cache\_npx\77cd0660cb120fdc若仍报错彻底清理npm cache clean--forceRemove-Item-Recurse-ForceC:\Users\admin\AppData\Local\npm-cache\_npx然后回 CodeBuddy 禁用再启用redis-server-local。坑 5改了配置但仍报旧错现象明明改了mcp.json还是报之前的HELLO错。原因旧 MCP 进程仍在后台运行改文件不自动重启。解决必须手动「禁用 → 启用」或重启 CodeBuddy。判断新连接是否生效看该 MCP 的「已发现工具」是否正常加载、工具名是否变化Python 版有scan_all_keysNode.js 版有keys。五、排错速查表报错 / 现象根因解决拉包超时pypi 源慢加UV_INDEX_URL镜像pip找不到包Python 版本低改用uvxunknown command HELLO官方 Python 版发 RESP3Redis6.0 不支持换wenit/redis-mcp-serverNode 版ENOENT ... zod/.../ur.jsnpx 缓存损坏删_npx缓存重下改配置无效、仍报旧错旧进程没重启禁用再启用 / 重启客户端Connection closed -32000MCP 进程启动即崩溃看具体报错多为依赖缺失或配置错六、关键经验总结Redis 版本 6.0直接用 Node.js 版 MCPwenit/redis-mcp-server别碰 Python 官方版能省掉HELLO协议坑。改完mcp.json一定要重启 MCP 连接配置不会热更新。npx首次运行会拉依赖网络差 / 缓存损坏时清_npx缓存再来。用工具名判断当前跑的是哪个版本scan_all_keys Python 版keys Node 版。密码型 URL 格式redis://:密码host:port/db密码前的冒号不能少。附验证成功后可做的操作- 列出所有 keykeys {pattern: *} - 按前缀筛选keys {pattern: graph:*} - 查看某 key 内容get / hgetall 等对应工具 - 连通性测试ping