v1.0.3

🚀 新特性 (Features)

• docker: Docker-compose 优先消费官方 GHCR 镜像并发布 v1.0.3 (d6b27af)

v1.0.2

📝 文档变动 (Documentation)

• 补充开箱即用的环境变量配置模板 .env.example 并升级版本至 1.0.2 (b178b19)

🧹 杂项维护 (Chore)

• 移除人工维护的 CHANGELOG.md 并完全由 git-cliff 自动化托管 (91701d8)

v1.0.1

🚀 新特性 (Features)

• ci: 集成 oss-template 现代工程化套件与自动化 CI/CD 流水线 (8aa9263)

v1.0.0 - Production Release

atengk-mcp-server-redis v1.0.0 生产级首发正式版发布！

atengk-mcp-server-redis 是专为大语言模型（LLM）打造的高性能、安全可控的生产级 Redis 模型上下文协议（Model Context Protocol, MCP）服务，基于 Python 与 FastMCP 构建。

---

🌟 核心特性与架构亮点

1. 工业级安全防御体系 (Dual Write Gate)

• 强只读安全守卫：默认全局只读，写操作必须由启动标志 --allow-write 显式授权且目标连接 readonly 必须为 false，双重保险防误改；
• 破坏性指令物理切断：硬编码物理阻断 FLUSHALL、FLUSHDB、SHUTDOWN、CONFIG、DEBUG 及阻塞式 KEYS *；
• 高危删除二次确认门禁：redis_delete_keys 强制携带 confirm: bool = False，未确认时仅返回受影响预估，显式传 confirm=True 方可执行物理删除；
• 防 OOM 集合切片守卫：对 Hash、List、Set、ZSet、Stream 五大复杂结构强制实施切片截断与数量上限保护。

2. Redis Cluster 分片集群原生自适应驱动

• 协议自适应识别与净化：原生识别 redis-cluster:// 与 rediss-cluster:// 协议头，物理剥除 URL 尾部路径，支持 MCP_REDIS_CLUSTER=true 与多实例 cluster: true 双模激活；
• 单一逻辑库 (DB 0) 强制防御：严格遵循集群单库约束，检测到非 0 库请求自动告警并重置绑定至 db=0，绝不因切库异常抛出 ResponseError 导致会话崩溃；
• 跨槽 (Cross-Slot) 安全防御与并发提速：redis_delete_keys 在集群模式与 CROSSSLOT 异常时自动采用 asyncio.gather 并发单键独立删除，彻底阻断跨槽崩溃并杜绝串行网络 N+1 延迟；
• 全节点聚合扫描：redis_scan_keys 自适应调用 client.scan_iter 遍历全部分片 Master 节点并聚合键列表。

3. Stdio 与 SSE 双模传输网关

• 无缝向后兼容：默认原生 Stdio 管道交互，100% 严格向后兼容所有已有 AI 客户端（Claude Desktop、Cursor 等）；
• HTTP Server-Sent Events (SSE) 服务端：支持 --transport sse --host 0.0.0.0 --port 8000，支持以微服务常驻网络形态对外暴露端点 /sse。

4. 生产级容器化套件与常驻编排

• 多阶段极速构建 (Dockerfile)：基于 python:3.11-slim 与 ghcr.io/astral-sh/uv:latest 分层缓存构建，产出镜像严格小于 150MB；
• 非 Root 生产安全基线：专有系统账号 appuser (UID: 10001) 运行，锁定登录 Shell（/usr/sbin/nologin），满足企业合规审计；
• 单服务常驻编排 (docker-compose.yml)：默认以 SSE 模式常驻运行并映射 8000:8000 端口，预置 host.docker.internal:host-gateway 跨平台直连宿主机外部 Redis。

5. 智能序列化与数据自适应

• 自适应 UTF-8 / Base64 转码：字符串自动解码，非文本二进制自动转为 Base64 并标明 is_binary: True；
• 智能 JSON 探测 (Smart JSON Parsing)：遇到合法 JSON 文本自动转换为结构化字典/列表对象（json_data）；
• 超长文本截断：长文本/Base64 超出阈值安全截断并附带 is_truncated: True 及原始总长度。

6. 全套 18 个生产级 MCP 工具矩阵

• 覆盖实例与连接、键空间检索诊断、字符串读写与删除门禁、复杂集合消息流、运维性能诊断五大领域。

7. 生产级网络超时防护与运行时日志调控

• 注入默认 socket_connect_timeout=3.0s 与 socket_timeout=5.0s，支持环境变量自定义调控；集群驱动开启 3 次故障重试；
• 支持 --log-level 与 MCP_REDIS_LOG_LEVEL 动态调节日志级别（DEBUG/INFO/WARNING/ERROR），输出流严格绑定至 sys.stderr。

---

📦 快速使用

# 方式 1：使用 uvx 免安装直接运行
uvx atengk-mcp-server-redis --url "redis://localhost:6379/0"

# 方式 2：使用 pip 安装
pip install atengk-mcp-server-redis

# 方式 3：使用 Docker Compose 启动 HTTP SSE 常驻服务
docker-compose up -d