Redis MCP Server Docker

Redis MCP服务器

Redis数据管理的多架构Docker镜像

______________________________________________________________________

目录

• 概述
• 支持的架构
• 可用标签
• 快速开始
• 配置
• MCP客户端配置
• 网络配置
• 更新
• 故障排除
• 附加资源
• 支持和许可

______________________________________________________________________

😎 请我喝杯咖啡☕︎

您的支持鼓励我继续创建/支持我的开源项目。 如果你在这个项目中发现了价值，你可以给我买杯咖啡，让我保持灵感。

概述

Redis MCP Server是一个模型上下文协议服务器，提供管理Redis数据库和与Redis数据库交互的工具。基于Alpine Linux构建，以实现最小的占地面积和最大的安全性，并采用Supergateway进行HTTP/SSE/Webocket传输。

主要特点

• 多架构支持 -原生支持x86-64和ARM64
• 多种传输协议 -HTTP、SSE和WebSocket支持
• 设计安全 -基于阿尔卑斯山，攻击面最小
• 高性能 -ZSTD压缩可实现更快的部署
• 生产就绪 -经过全面测试的稳定版本
• 易于配置 -简单的环境变量设置

______________________________________________________________________

支持的架构

多拱形图像会自动为您的系统选择正确的架构。

______________________________________________________________________

可用标签

系统要求

• Docker引擎： 23.0+
• 猛撞： 最小512MB
• CPU： 单芯足够

关键： 在没有适当的安全措施（反向代理、SSL/TLS、身份验证、防火墙规则）的情况下，不要将此容器直接暴露在互联网上。

______________________________________________________________________

快速开始

Docker Compose（推荐）

services:
  redis-mcp-server:
    image: mekayelanik/redis-mcp-server:stable
    container_name: redis-mcp-server
    restart: unless-stopped
    ports:
      - "8030:8030"
    environment:
      - PORT=8030
      - INTERNAL_PORT=38011
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Dhaka
      - PROTOCOL=HTTP
      - ENABLE_HTTPS=false
      - HTTP_VERSION_MODE=auto
      # Redis connection settings
      # - REDIS_URL=redis://localhost:6379
      # - REDIS_HOST=localhost
      # - REDIS_PORT=6379
      # - REDIS_USERNAME=
      # - REDIS_PWD=
      # - REDIS_DB=0
      # - REDIS_SSL=false
      # - REDIS_SSL_CA_PATH=
      # - REDIS_SSL_KEYFILE=
      # - REDIS_SSL_CERTFILE=
      # - REDIS_SSL_CERT_REQS=required
      # - REDIS_SSL_CA_CERTS=
      # - REDIS_CLUSTER_MODE=false
      # Optional: require Bearer token auth at HAProxy layer
      # - API_KEY=replace-with-strong-secret
    hostname: redis-mcp-server
    domainname: local

部署：

docker compose up -d
docker compose logs -f redis-mcp-server

Docker命令行界面

docker run -d \
  --name=redis-mcp-server \
  --restart=unless-stopped \
  -p 8030:8030 \
  -e PORT=8030 \
  -e INTERNAL_PORT=38011 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Dhaka \
  -e PROTOCOL=HTTP \
  -e ENABLE_HTTPS=false \
  -e HTTP_VERSION_MODE=auto \
  mekayelanik/redis-mcp-server:stable

访问端点

启用HTTPS时(ENABLE_HTTPS=true)，使用TLS端点：

安全警告： 容器现在默认为HTTP(ENABLE_HTTPS=false)以便于本地设置。使用 ENABLE_HTTPS=true 用于生产、公共网络或任何不受信任的环境。 ARM设备： 在访问端点之前，请允许30-60秒进行初始化。

______________________________________________________________________

配置

环境变量

HTTPS和HTTP版本说明

• 如果 ENABLE_HTTPS=true 如果缺少证书文件，容器会自动生成自签名证书。
• 如果 TLS_CERT_PATH 和 TLS_KEY_PATH 存在，它们被合并到 TLS_PEM_PATH 并直接使用。
• HTTP_VERSION_MODE=h3 （或 auto)仅当HAProxy构建包含QUIC时才启用HTTP/3；否则，它会安全地回落。

API密钥验证说明

• 集 API_KEY 以在反向代理级别强制执行身份验证。
• 预期的标题格式： Authorization: Bearer .
• 本地主机健康检查仍然可以访问活动/准备状态。

速率限制和IP访问控制

• 速率限制： 集 RATE_LIMIT=100 允许每100个请求 RATE_LIMIT_PERIOD （默认值 10s)每个IP。超过限制将返回HTTP 429 Retry-After 头球
• 连接限制： 集 MAX_CONNECTIONS_PER_IP=50 限制每个IP的并发连接。超过此值将返回HTTP 429。
• IP阻止列表： 集 IP_BLOCKLIST=192.0.2.0/24,198.51.100.5 以阻止特定IP/CIDR。被阻止的IP接收HTTP 403。
• IP地址列表： 集 IP_ALLOWLIST=10.0.0.0/8,192.168.1.0/24 只允许列出的IP/CIDR。所有其他人都接收HTTP 403。始终允许本地主机。
• 所有功能默认为禁用。根据需要进行组合——在分配列表之前检查块列表。

用户和组ID

找到您的ID并设置它们以避免权限问题：

id username
# uid=1000(user) gid=1000(group)

时区示例

- TZ=Asia/Dhaka        # Bangladesh
- TZ=America/New_York  # US Eastern
- TZ=Europe/London     # UK
- TZ=UTC               # Universal Time

______________________________________________________________________

MCP客户端配置

运输支持

______________________________________________________________________

VS代码（Cline/Roo-Cline）

在中配置 .vscode/settings.json:

{
  "mcp.servers": {
    "redis-mcp": {
      "url": "http://host-ip:8030/mcp",
      "transport": "http"
    }
  }
}

______________________________________________________________________

克劳德桌面应用程序/克劳德代码

使用API_KEY：

claude mcp add-json redis-mcp '{"type":"http","url":"http://localhost:8030/mcp","headers":{"Authorization":"Bearer "}}'

不带API_KEY：

claude mcp add-json redis-mcp '{"type":"http","url":"http://localhost:8030/mcp"}'

______________________________________________________________________

Codex CLI

在中配置 ~/.codex/config.json:

{
  "mcpServers": {
    "redis-mcp": {
      "transport": "http",
      "url": "http://host-ip:8030/mcp"
    }
  }
}

______________________________________________________________________

Codeium（风帆）

在中配置 .codeium/mcp_settings.json:

{
  "mcpServers": {
    "redis-mcp": {
      "transport": "http",
      "url": "http://host-ip:8030/mcp"
    }
  }
}

______________________________________________________________________

光标

在中配置 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "redis-mcp": {
      "transport": "http",
      "url": "http://host-ip:8030/mcp"
    }
  }
}

______________________________________________________________________

测试配置

证实 MCP检查员:

npm install -g @modelcontextprotocol/inspector
mcp-inspector http://host-ip:8030/mcp

______________________________________________________________________

网络配置

比较

______________________________________________________________________

网桥网络（默认）

services:
  redis-mcp-server:
    image: mekayelanik/redis-mcp-server:stable
    ports:
      - "8030:8030"

优点： 容器隔离，易于设置，适用于任何地方 访问权限： http://localhost:8030/mcp

______________________________________________________________________

主机网络（仅限Linux）

services:
  redis-mcp-server:
    image: mekayelanik/redis-mcp-server:stable
    network_mode: host

优点： 最高性能，无NAT开销，无需端口映射 注意事项： 仅限Linux，共享主机网络命名空间 访问权限： http://localhost:8030/mcp

______________________________________________________________________

MACVLAN网络（高级）

services:
  redis-mcp-server:
    image: mekayelanik/redis-mcp-server:stable
    mac_address: "AB:BC:CD:DE:EF:01"
    networks:
      macvlan-net:
        ipv4_address: 192.168.1.100

networks:
  macvlan-net:
    driver: macvlan
    driver_opts:
      parent: eth0
    ipam:
      config:
        - subnet: 192.168.1.0/24
          gateway: 192.168.1.1

优点： 专用IP，直接局域网接入 注意事项： 仅限Linux，需要额外设置 访问权限： http://192.168.1.100:8030/mcp

______________________________________________________________________

更新

Docker Compose

docker compose pull
docker compose up -d
docker image prune -f

Docker命令行界面

docker pull mekayelanik/redis-mcp-server:stable
docker stop redis-mcp-server && docker rm redis-mcp-server
# Run your original docker run command
docker image prune -f

Watchtower的一次性更新

docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once \
  redis-mcp-server

______________________________________________________________________

故障排除

飞行前检查表

• Docker引擎23.0+
• 端口8030可用
• 充足的启动时间（ARM设备）
• 最新稳定图像
• 配置正确

常见问题

容器无法启动

# Check Docker version
docker --version

# Verify port availability
sudo netstat -tulpn | grep 8030

# Check logs
docker logs redis-mcp-server

权限错误

# Get your IDs
id $USER

# Update configuration with correct PUID/PGID
# Fix volume permissions if needed
sudo chown -R 1000:1000 /path/to/volume

客户端无法连接

# Test connectivity
curl http://localhost:8030/mcp
curl http://host-ip:8030/mcp
curl -k https://localhost:8030/mcp
curl -k https://host-ip:8030/mcp

# Check firewall
sudo ufw status

# Verify container
docker inspect redis-mcp-server | grep IPAddress

ARM性能缓慢

• 启动后等待30-60秒
• 监视器： docker logs -f redis-mcp-server
• 检查资源： docker stats redis-mcp-server
• 使用更快的存储（SSD与SD卡）

调试信息

报告问题时，包括：

# System info
docker --version && uname -a

# Container logs
docker logs redis-mcp-server --tail 200 > logs.txt

# Container config
docker inspect redis-mcp-server > inspect.json

______________________________________________________________________

附加资源

文档

• Redis MCP上游
• PyPI包
• MCP检查员

Docker资源

监控

• Diun-更新通知器
• 守望塔

______________________________________________________________________

😎 请我喝杯咖啡☕︎

您的支持鼓励我继续创建/支持我的开源项目。 如果你在这个项目中发现了价值，你可以给我买杯咖啡，让我保持灵感。

支持和许可

获取帮助

Docker镜像问题：

• github：

Redis MCP问题：

• github： redis/mcp redis/问题

贡献

我们欢迎捐款：

1. 通过GitHub Issues报告错误
2. 建议功能
3. 改进文档
4. 测试版发布

许可证

GPL许可证。看 许可证 了解详情。

Redis MCP服务器有自己的许可证-请参阅 上游仓库.

______________________________________________________________________

返回顶部